VSCode怎么连接MySQL/Redis数据库并查看数据
作者:FreshDream
时间:2026-07-06
浏览:0
使用VSCode插件连接数据库时:MySQL需注意caching_sha2_password认证兼容性,推荐使用DatabaseClient插件;Redis插件依赖本地redis-cli,需正确设置host和密码参数;执行SQL文件需显式绑定连接;另外需排查数据库权限、防火墙规则及IPv6解析等底层问题。
VSCode本身不提供直接连接数据库的功能,所有操作全靠插件“借力”。而且MySQL和Redis的底层机制、认证方式、网络要求几乎是两套体系,千万别拿同一套配置逻辑去套用——那样肯定会出问题。

MySQL连不上?先排查 caching_sha2_password 认证协议是否卡住
MySQL 8.0及以上版本默认采用 caching_sha2_password 认证,但不少老旧的插件(比如已经停止维护的 vscode-mysql)只认 mysql_native_password。一旦碰到这种情况,就会直接报错“Client does not support authentication protocol”。
解决方案其实很清晰:
- 首选推荐安装
Database Client(作者 cweijan),它原生支持caching_sha2_password,输入host、port、user、password,点测试连接就能通过 - 备选方案是用
SQLTools搭配SQLTools MySQL Driver(作者 mtxr),但注意装完之后一定要重启VSCode,否则驱动不会自动加载 - 如果实在想降级兼容,可以在MySQL服务端执行这条命令:
ALTER USER 'dev'@'%' IDENTIFIED WITH mysql_native_password BY 'xxx'; FLUSH PRIVILEGES;
Redis连不上?多半是本地没装 redis-cli 或host填错了
VSCode上的Redis插件(比如Redis Explorer)其实不是独立客户端,它本质上是调用系统PATH里的 redis-cli 来发送命令。要是没装或者路径不对,连图标都点不亮。
几个关键检查点:
- 先打开终端运行
redis-cli --version,确认能正常使用。不行就安装:macOS用brew install redis,Ubuntu用sudo apt install redis-tools - Docker环境下千万别填
localhost。macOS和Windows要填host.docker.internal,Linux填宿主机真实IP - 密码字段不能留空——部分插件会静默跳过认证,导致连上了却查不到任何键。要么明确填
"password": "",要么直接删掉该字段 - 默认端口是
6379,不是6380或63790。另外Redis Stack的HTTP端口(8080)不能用来直连数据库
SQL文件执行没反应?因为没有显式绑定连接
VSCode不会自动关联 .sql 文件和某个数据库。右键点击“执行”,结果弹出“No active connection”——这是最常见的误操作。
具体操作差异如下:
Database Client:打开SQL文件后,右上角会出现连接下拉框,必须手动选中一个已配置的MySQL连接SQLTools:需要先按Ctrl+Shift+P,输入SQLTools: Connect to Database激活连接,再执行- 执行粒度很关键:不选中任何语句就按
Ctrl+Enter,只会运行光标所在的那一行。想执行整个文件,得右键选择SQLTools: Run Current File - 结果表格里的大字段(比如
TEXT、JSON)默认会被截断,右键单元格选Copy Cell Value才能拿到完整内容
权限、防火墙、IPv6解析——这些底层问题最容易忽略
插件装对了,配置也填对了,可还是连不上?那八成是服务层或网络层出了问题。
几个高频陷阱:
- MySQL用户没有开启远程权限:执行
CREATE USER 'dev'@'%' IDENTIFIED BY 'xxx'; GRANT ALL ON *.* TO 'dev'@'%'; FLUSH PRIVILEGES; - MySQL只监听
127.0.0.1,但插件用localhost解析到了IPv6的::1,结果直接超时。统一改用127.0.0.1就能避开这个坑 - 云服务器或Docker容器必须放行
3306/6379端口。Linux环境还要检查ufw或iptables是否拦截 - Redis如果启用了
protected-mode yes,又没有配置bind或requirepass,会直接拒绝所有外部连接
作者最新文章
vivo V80 曝光:10月发布,首推10倍人像变焦与蔡司夜景长焦
2026-09-08 17:00
PDF转Excel操作指南:极轻PDF在线工具使用步骤与结果核对
2026-09-02 19:02
Blender 3D动画制作入门:绑定、关键帧、灯光与渲染全流程
2026-09-02 11:10
PS教程:图层、选区、蒙版与调色核心操作
2026-09-02 10:12
iQOO Pro(12GB/128GB/5G全网通)忘了手机密码怎么办?
2026-08-25 15:47
热门文章
更多
精品专题
更多
Mac软件
更多
WINDOWS
更多


































