可在 vscode 中通过安装 database Client、sqlTools 或sqlite 扩展实现 数据库 操作;Database Client 支持多协议连接与表查询,SQLTools 需配合驱动使用,SQLite 扩展可直接浏览本地。db 文件,docker数据库需正确配置 端口 映射与访问权限。

如果您希望在 VSCode 中无需切换到独立数据库管理 工具 即可执行查询、浏览表结构或导入导出数据,则可能是由于缺乏合适的扩展支持或配置未生效。以下是实现该目标的多种方法:
本文运行环境:macBook Air,macOS Sequoia。
一、安装 Database Client 扩展
Database Client 是一个轻量级但功能完整的 VSCode 扩展,支持mysql、postgresql、SQLite、SQL Server 等多种数据库协议,允许直接在侧边栏建立连接并执行 SQL 语句。
1、打开 VSCode,点击左侧活动栏的扩展图标(或按快捷键 Ctrl+Shift+X)。
2、在搜索框中输入Database Client,找到作者为 cweijan 的扩展并点击“安装”。
3、安装完成后重启 VSCode,点击左侧活动栏底部的数据库图标(数据库形状的图标)。
4、点击“+”号添加新连接,选择对应数据库类型,填写主机、端口、用户名、密码及数据库名。
5、连接成功后,双击数据库名称展开,右键表名可选择“Query table”快速查看数据。
二、使用 SQLTools 扩展套件
SQLTools 提供模块化 架构,核心插件配合特定数据库驱动(如 PostgreSQL Driver、MySQL Driver)协同工作,支持连接管理、语法高亮、自动补全与结果集分页显示。
1、在扩展市场中搜索并安装 SQLTools 核心扩展。
2、根据所用数据库,单独安装对应驱动,例如:若使用 PostgreSQL,则额外安装SQLTools PostgreSQL Driver。
3、按下 Cmd+Shift+P(macos)调出命令面板,输入“SQLTools: Add Connection”,回车。
4、按提示依次选择驱动、填写连接参数;完成配置后,连接将出现在 SQLTools 侧边栏。
5、右键连接→“Open SQL File”,新建 SQL 文件,输入select * FROM users; 后按 Cmd+Enter 执行。
三、启用 SQLite 内置支持(仅限本地 SQLite 文件)
VSCode 原生不支持数据库连接,但通过 SQLite 扩展可直接打开。db 文件,以表格形式浏览内容,并支持执行任意 SQL 语句,无需配置远程服务或认证信息。
1、在扩展市场中搜索并安装 SQLite 扩展(作者 maty21)。
2、将本地 SQLite 数据库文件(如app.db)拖入 VSCode 资源管理器中。
3、双击该文件,界面自动切换为表格视图,顶部显示行数与列结构。
4、点击右上角“SQL”按钮,进入 SQL 编辑模式,在编辑区输入查询语句。
5、选中语句后按 Cmd+Enter,结果以网格形式显示在下方面板中。
四、配置 Docker 容器内数据库的远程连接
当数据库运行在本地 Docker 容器中时,需确保端口映射正确且 VSCode 扩展能通过 host.docker.internal(macOS/linux)或 127.0.0.1(windows)访问服务。
1、启动容器时添加 - p 参数,例如:docker run -d -p 5432:5432 –name pgdb -e POSTGRES_PASSword=pass postgres。
2、在 Database Client 或 SQLTools 中新建连接,Host 填写localhost,Port 填写映射端口(如 5432)。
3、验证容器是否运行:终端执行 docker ps | grep pgdb,确认状态为 Up。
4、若连接被拒绝,检查 PostgreSQL 配置文件 postgresql.conf 中 listen_addresses 是否包含‘localhost’。
5、同时确认 pg_hba.conf 中存在类似 host all all 127.0.0.1/32 md5 的权限规则。