VSCode需安装MongoDB扩展才能连接数据库，且必须确保mongod服务运行、连接字符串格式正确、认证参数完整；操作数据须通过Playground执行原生命令，JSON视图仅只读。
VSCode 本身不内置数据库连接能力，必须靠 MongoDB for VS Code 扩展实现可视化操作；它不是“连上就能查”，而是依赖正确格式的连接字符串、服务端可访问性，以及本地 mongod 进程是否真正在运行——很多人卡在“显示已连接”但点不开集合，其实是服务没起来或权限被拒。
确认本地 mongod 是否真正运行（别只看端口）
很多人以为装了 MongoDB 就自动启动了，其实 Community Edition 安装后默认不自启。直接连 mongodb://localhost:27017 失败，大概率是这个原因。
- Windows：打开任务管理器 → “服务”标签页 → 找到
MongoDB Server，状态必须是“正在运行”；没运行就右键启动 - macOS/Linux：终端执行
ps aux | grep mongod，有输出才说明进程活着；没有就手动启动：mongod --dbpath /usr/local/var/mongodb（macOS Homebrew 默认路径） - 验证方式：不靠 VSCode，直接终端运行
mongo --eval "db.runCommand({ping: 1})"，返回{ "ok" : 1 }才算通
添加连接时字符串写法与常见错误
扩展对连接字符串格式敏感，尤其认证部分容易少写或错位。以下都是真实踩坑过的写法：
- 本地无认证：用
mongodb://localhost:27017即可；如果改过端口（比如用 Docker 映射到 27018），必须显式写成mongodb://localhost:27018 - 本地带认证：不能只写
mongodb://user:pass@localhost:27017，缺/?authSource=admin会连上但鉴权失败，完整写法是mongodb://user:pass@localhost:27017/?authSource=admin - Atlas 连接：必须用
mongodb+srv://开头，且确保 DNS 解析正常；若提示getaddrinfo ENOTFOUND，先nslookup cluster.mongodb.net看是否能解析 - 千万别把密码里含的
/、@、:直接塞进 URL——得用encodeURIComponent()编码，比如密码是pa@ss/word，要写成pa%40ss%2Fword
双击集合没反应或只加载 20 条？检查这几个隐藏开关
扩展默认只拉取前 20 条文档并禁用实时更新，看起来像“卡住”，其实是设计如此。想真正操作数据，得主动触发更多动作：
- 双击集合后，编辑器里显示的是只读 JSON 视图；如需编辑某条文档，必须点击右侧的
View in Editor按钮，再点顶部的铅笔图标切换为可编辑模式 - 分页控件在右下角，但默认不自动加载下一页——必须手动点
Load more或改右上角的Limit值（比如改成 100） - 如果集合数据量大（>5000 文档），首次展开可能延迟明显；此时不要反复点击，等左下角状态栏出现
Loaded X documents再操作 - 聚合管道调试时，
aggregate()编辑框里写的阶段不能用缩进换行来“美化”，必须是合法 JS 对象字面量，例如：[{ $match: { status: "active" } }, { $sort: { createdAt: -1 } }]
增删改查必须用 Playground，而不是直接改 JSON
很多人误以为在文档 JSON 视图里改完点保存就能入库，其实不行——那个视图只是快照，所有写操作必须走 Playground 执行命令。
- 右键集合 →
Create MongoDB Playground，会生成一个.mongodb文件 - 在里面写原生驱动语法，比如插入：
db.users.insertOne({ name: "Tom", email: "tom@example.com" }) - 选中整行或光标所在行，按
Ctrl+Enter（Win/Linux）或Cmd+Enter（macOS）执行 - 删除操作慎用
deleteMany({})，扩展不会弹二次确认；建议先find({})预览，再换deleteMany - 修改推荐用
updateOne+$set，避免意外覆盖整个文档；例如：db.users.updateOne({ _id: ObjectId("...") }, { $set: { email: "new@example.com" } })
最容易被忽略的是：Playground 里的命令执行环境是独立的，它不共享 Node.js 项目里的 Mongoose 模型或中间件逻辑。你在这里删一条，Mongoose 的 pre('remove') 钩子根本不会触发——它就是直连 driver 层的裸操作。
