vscode mongodb插件连不上或查不到数据，主因是mongod未运行或连接字符串格式错误；需确保mongod进程启动、端口正确、协议完整、密码url编码、库名一致、权限匹配，并手动刷新集合列表。
VSCode 里装了 MongoDB 插件却连不上、看不到集合、查不到数据——90% 的问题不是插件坏了，而是 mongod 没真在跑，或者连接字符串格式错了一处。
为什么点“Connect”一直转圈或报 Connection refused
插件不启动服务，只发起 TCP 连接；它失败，说明底层根本没通上。这不是配置问题，是环境缺失。
-
mongod进程必须已运行：macOS/Linux 执行ps aux | grep mongod，Windows 在任务管理器搜mongod.exe - 默认端口是
27017，改过就必须显式写进连接串，比如mongodb://localhost:27018 - 本地连接必须带完整协议头：
mongodb://localhost:27017✅，localhost:27017❌（解析失败） - Docker 启动时，确认端口映射正确：
-p 27017:27017，且bindIp包含127.0.0.1
连接字符串怎么填才不被解析失败
插件用 Node.js 的 url.parse() 解析，对空格和特殊字符零容忍。一个 @ 写错位置，密码就被截断。
- 密码含
@、/、:等字符？必须 URL 编码：例如pa@ss/word→pa%40ss%2Fword - 快速编码方法：浏览器控制台执行
encodeURIComponent('pa@ss/word') - 末尾加数据库名（如
mongodb://localhost:27017/myapp）只影响默认打开的库，不影响连接本身 - 前后不能有空格：
mongodb://...或mongodb://...都会报Invalid connection string
连上了却看不到集合，或者查不到刚写入的文档
不是插件 bug，是上下文或权限没对齐。Mongoose 写进去了，插件却在另一个库、另一个用户权限下看数据。
- 右键连接节点 → Refresh，强制重载集合列表（尤其当集合名以
system.或纯数字开头时） - 检查认证用户是否被授予目标库的
readWrite角色：用mongosh连上去，执行db.runCommand({connectionStatus: 1})，看authInfo.db和authenticatedUsers - 插件连接串末尾的库名（如
/mydb）和mongoose.connect('mongodb://.../mydb')必须一致，否则model()创建的集合可能归属不同库 - 查询语句必须是合法 BSON 对象：
{ "name": "Alice" }✅，{ name: "Alice" }❌（JS 字面量不支持）
执行聚合或更新时报错，但 mongosh 里能跑
插件底层调用的是 MongoDB Node.js Driver，不是 shell。部分语法、类型、响应大小有限制。
- 不支持
db.collection.aggregate(...).toArray()这类链式调用，只接受原始 pipeline 数组：[{ $match: { status: "active" } }] - 写操作（
updateOne、deleteMany）需显式开启：右键集合 → Run Update Query，不能直接在查询面板点运行 - 大结果集可能被截断或超时；想看全量，导出为 JSON 或换用
mongosh - 时间字段（
Date、ObjectId）显示为字符串是正常序列化行为，不是数据丢失
最常漏掉的其实是：连上之后没刷新集合列表、没确认用户权限落在哪个库、以及把 shell 语法直接粘贴进插件查询框。这些地方一卡，就以为插件坏了。
