vscode 无法直接连接 cloudflare d1 数据库，因其无服务端、不暴露网络端口、不支持 jdbc/odbc 或标准数据库协议；所有操作须通过 wrangler d1 cli 或 workers 内部调用完成。
VSCode 无法直接连接或查询 Cloudflare D1 数据库——D1 没有传统数据库服务端，也不支持 JDBC/ODBC 或本地 socket 连接；所有 D1 操作必须通过 wrangler d1 CLI 或 Workers 内部调用完成。
为什么不能像 MySQL 那样配 SQLTools 连 D1
D1 是基于 SQLite 的无服务器数据库，但它的运行模型和部署方式完全不同：它不暴露网络端口、不运行常驻进程、不接受外部连接请求。你本地的 VSCode 和远程 D1 数据库之间没有 TCP 层通信路径，SQLTools、Database Client 等插件依赖的驱动协议（如 PostgreSQL wire protocol）在 D1 上根本不存在。
常见错误现象包括：
- 在 SQLTools 中填入
localhost:8787或任意端口后提示 “Connection refused” - 尝试用
sqlite3 ./local.db打开 D1 生成的文件失败，因为 D1 的本地模拟文件是加密+封装格式，非标准 SQLite 文件 - 误以为
wrangler d1 execute支持交互式 REPL，实际它只执行单条语句并退出，无法替代 VSCode 内置查询面板
正确做法：用 wrangler d1 命令行 + VSCode 内联脚本协同开发
你真正能用上的开发流是「VSCode 编辑 SQL → 终端执行 wrangler d1 execute → 查看 JSON 输出」。这不是“连接”，而是命令驱动的离线查询。
实操建议：
- 确保已登录并绑定 D1 数据库：
wrangler login，然后wrangler d1 create mydb，再wrangler d1 binding create mydb --binding DB - 在 VSCode 中新建
query.sql，写好语句如SELECT * FROM users LIMIT 5; - 终端执行：
wrangler d1 execute mydb --file query.sql --json（加--json可避免格式错乱） - 若需频繁调试，可配置 VSCode 任务：
.vscode/tasks.json中添加一个shell类型 task，自动读取当前打开的.sql文件并执行
本地开发时如何预览 D1 查询结果
D1 提供 wrangler d1 dev（v3.90+）启动本地 SQLite 模拟服务，但它仍不开放直连接口，仅用于 wrangler dev 启动 Workers 时内部调用。你无法用 VSCode 插件连它，但可以：
- 在 Worker 脚本中加
console.log打印查询结果，配合wrangler dev实时查看 - 用
wrangler d1 dump mydb --file dump.json导出快照，在 VSCode 中用 JSON 插件浏览结构 - 对简单场景，直接用 Node.js 调用
sqlite3包打开dump.json对应的原始 SQLite 文件（仅限wrangler d1 export产出的未加密备份）
注意：wrangler d1 export 生成的是标准 SQLite 文件，而 wrangler d1 dev 临时生成的 .sqlite 文件受 Miniflare 封装保护，不可直接打开。
生产环境唯一可观测手段只有 wrangler tail + 日志埋点
部署后，D1 查询完全发生在 Workers runtime 内部，没有任何远程查询终端或控制台。你不能 SSH 进去、不能 attach、不能执行 ad-hoc SQL。
能做的只有：
- 在 Worker 中用
console.log(JSON.stringify(result))输出关键查询结果 - 运行
wrangler tail --format json实时捕获日志流 - 结合
console.error和try/catch把 D1 错误（如SqliteError: no such table）显式打出来
容易被忽略的一点是：D1 的 schema 变更（CREATE TABLE 等）必须随 Workers 代码一起部署，且仅在首次部署时执行；后续修改不会自动迁移——这和你在 VSCode 里点几下就改表结构的体验截然不同。
