VSCode需安装对应数据库扩展（如MySQL用cweijan版、PostgreSQL用ms-ossdata版）并手动配置连接参数；常见问题包括特殊字符密码需URL编码、SSL模式不匹配、认证插件不兼容；执行SQL依赖快捷键与语句分隔规则，结果导出推荐Save As CSV，密码明文存储需谨慎处理。
vscode 本身不内置数据库管理功能，必须通过扩展实现查询与管理；直接安装插件后开箱即用的体验有限，多数场景需要手动配置连接参数、处理认证方式或调整 sql 执行行为。
安装支持数据库的扩展（如 SQL Server (mssql) 或 MySQL）
VSCode 市场中主流数据库都有对应扩展，但命名易混淆——比如搜索 “MySQL” 会看到多个结果，真正维护活跃且支持连接管理的是 MySQL（作者：cweijan），而非已停更的 mysql（小写）。
- 安装前先确认目标数据库类型：PostgreSQL 推荐
PGSQL（作者：ms-ossdata），SQLite 可用内置SQLite Viewer或SQLite Explorer - 扩展启用后不会自动弹出连接界面，需手动触发命令面板（
Ctrl+Shift+P/Cmd+Shift+P），输入MySQL: Connect或PostgreSQL: Connect - 部分扩展（如
mssql）依赖系统已安装的sqlcmd工具，Windows 用户通常自带，macOS/Linux 需单独安装mssql-tools
配置数据库连接时常见报错及绕过方法
连接失败最常出现在密码含特殊字符、SSL 设置不匹配、或端口未开放。错误信息如 Failed to connect: Error: Connection timeout 并不一定代表网络不通，也可能是认证阶段卡住。
Windows TTS (WSL2)
下载
在 Windows 11 上"直接发声"的 TTS（从 WSL2/TUI 调用 powershell.exe + System.Speech）。适用于用户说"说出来/读出来/语音播报/用TTS"，或反馈"没声音/tts 生成的 mp3 是空的/播不出来"，以及需要中文语音但 OpenClaw 内置 tts 不可用时。
- 密码含
@、/、:等字符时，URL 形式连接串需对密码做encodeURIComponent编码（例如原始密码pa@ss/word→pa%40ss%2Fword） - PostgreSQL 默认启用
sslmode=require，若服务端未配 SSL，需在连接配置里显式设为sslmode=disable - MySQL 8.0+ 默认使用
caching_sha2_password插件，旧版客户端可能不兼容；可在连接参数中添加"authPlugin":"mysql_native_password"
执行 SQL 查询与查看结果的实用技巧
不是所有扩展都支持高亮、格式化、结果导出；默认快捷键 Ctrl+Enter（Windows/Linux）或 Cmd+Enter（macOS）仅在光标位于语句内或选中语句时生效，否则会执行整个文件。
- 多语句执行需用分号
;分隔，但MySQL扩展默认只执行光标所在“逻辑块”（以空行或分号结尾），并非严格按分号切分 - 结果表格点击列头可排序，右键列名可“Copy Column”提取整列数据，适合快速比对
- 导出结果推荐用
Save As CSV（右键结果表），而非复制粘贴——后者会丢失 NULL 值和换行符 - 临时修改查询上下文（如切换 database）需重新连接，或在查询开头加
USE db_name;（MySQL）或SET search_path TO schema_name;（PostgreSQL）
连接配置一旦保存，VSCode 会以明文形式存入 settings.json 或扩展专属 JSON 文件，敏感环境务必禁用自动保存密码，改用手动输入或使用系统密钥链（如 macOS Keychain 支持需扩展显式开启）。
