VS Code 无内置 MongoDB 客户端，需先安装 mongosh 并在终端运行；连接前须确保 mongod 已启动且端口匹配，脚本执行需指定数据库名并注意异步支持版本。

vscode 里没有内置 mongo 客户端，得靠终端调用 mongosh

VS Code 本身不带 MongoDB 交互环境，所谓“运行 mongo 客户端”，实际是启动系统已安装的 mongosh（MongoDB 官方推荐的 Shell，替代了旧版 mongo）。你得先确认它装好了，再在 VS Code 内置终端里执行。

• mongosh 必须提前安装，macOS 可用 brew install mongosh，Windows 推荐从 官网下载 安装包，别只装 MongoDB Server 就以为够了
• VS Code 终端默认继承系统 PATH，但如果用的是 zsh/fish 或某些 IDE 启动方式（比如从 Dock 点开），PATH 可能没加载全——此时输入 which mongosh 返回空，就得手动把 mongosh 所在目录加进 VS Code 的 terminal.integrated.env.* 配置里
• 连接本地默认实例只需在终端输入 mongosh；连远程或指定端口则用 mongosh "mongodb://localhost:27018"

连不上？先查 MongoNetworkError 和 connect ECONNREFUSED

这两个错误最常见，本质都是客户端根本没连上服务进程。不是 VS Code 的问题，而是 MongoDB Server 没跑起来，或者端口被占、配置不对。

VSCode

避免常见的 VSCode 错误——设置冲突、调试器配置和扩展冲突。

下载

• mongosh 只负责发请求，不附带数据库服务——你得另外运行 mongod（或用 Docker：docker run -d -p 27017:27017 --name mongodb mongo:7）
• 默认端口是 27017，如果改过配置（比如 mongod --port 27018），mongosh 就必须显式指定，否则一直报 ECONNREFUSED
• macOS 上用 Homebrew 装的 mongod 可能默认绑定 127.0.0.1，而某些网络配置下 localhost 解析成 ::1（IPv6），导致连不上；临时解法是 mongosh "mongodb://127.0.0.1:27017"

想在编辑器里写 JS 脚本并运行？别直接 mongosh script.js

mongosh 支持执行文件，但行为和 Node.js 不同：它会把整个脚本丢进当前连接的数据库上下文执行，没有模块系统、不能 require，且默认不自动退出。

• 写完 test.js 后，在终端运行 mongosh localhost:27017/mydb test.js ——注意必须指定数据库名，否则脚本里的 db.collection.insertOne() 会报错
• 脚本末尾建议加 quit()，不然执行完卡在交互模式，容易误以为“卡死”
• 如果脚本含异步操作（比如 await db.collection.findOne()），确保用 mongosh v1.10+，老版本不支持顶层 await

插件不是必需的，但 mongo-mingo 这类扩展确实能省点事

VS Code 商店有几个 MongoDB 插件，比如 mongo-mingo，它本质是封装了 mongosh 的终端调用 + 语法高亮 + 连接管理 UI，不改变底层逻辑。

• 它不能绕过“没装 mongosh 就没法用”的前提，安装插件后第一次运行仍会提示你安装 mongosh
• 连接配置存在 VS Code 的 settings.json 里，明文存密码有风险；敏感环境建议还是手敲命令，或用 .mongoshrc.js 配置连接别名
• 插件的“格式化 BSON”功能依赖 mongosh 自身输出，对复杂嵌套或 ObjectId("...") 字符串的解析不如直接看 mongosh 原生输出稳定

事情说清了就结束。真正卡住的点往往不在 VS Code，而在 mongosh 是否可用、mongod 是否在监听、以及那条连接字符串里有没有漏掉数据库名或写错端口。