90%连不上是因为没运行mongod进程；插件仅为客户端，不自带服务，需确保mongod已启动、端口27017（或显式指定）开放、连接字符串含mongodb://协议头且无空格、密码特殊字符已URL编码，并确认用户权限匹配目标数据库。
装完插件连不上，90% 是因为没跑 mongod，不是插件问题。 MongoDB for VS Code 只是客户端，不带服务端；它不能替代 mongod 进程，也不能绕过认证、端口或网络限制。
为什么 MongoDB for VS Code 显示 “Connection refused” 或一直转圈
这是最常卡住的一步。插件尝试连接时，底层用的是标准 MongoDB Wire Protocol，一旦底层 TCP 连不上，就直接失败，不会提示“请先启动 mongod”。
- 检查
mongod是否真在运行：ps aux | grep mongod（macOS/Linux），或 Windows 任务管理器里搜mongod.exe - 默认端口是
27017，改过就必须显式写进连接字符串，比如mongodb://localhost:27018 - 本地连接必须带协议头：
mongodb://localhost:27017，写成localhost:27017或127.0.0.1都会解析失败 - 如果用 Docker 启动，确认容器端口已映射：
-p 27017:27017，且bindIp配置允许127.0.0.1
连接字符串里密码含 @、/、: 就连不上
URI 格式对特殊字符零容忍。插件调用 Node.js 的 url.parse() 解析连接串，未编码的 @ 会被当成用户名/密码分隔符，导致截断。
- 密码是
pa@ss/word？必须手动 URL 编码为pa%40ss%2Fword - 推荐用浏览器控制台快速处理：
encodeURIComponent('pa@ss/word') - 连接字符串末尾加数据库名（如
mongodb://localhost:27017/myapp）只是设置默认库，不影响连接本身 - 前后不要有空格——插件不 trim，
mongodb://...开头多一个空格就会报Invalid connection string
连上了却看不到集合，或者点开集合查不到数据
不是插件 Bug，而是权限或视图逻辑没对上。插件默认用连接串末尾的库名（或 test）做上下文，但认证用户可能没被授权访问那个库。
- 用
mongosh连上去，执行db.runCommand({connectionStatus: 1})，看authInfo.authenticatedUsers和authInfo.db字段 - 如果用户是在
admin库创建的，但连接串指向mydb，就得确保该用户有mydb的readWrite角色 - 集合名以
system.开头（如system.views）或纯数字开头（如123logs），插件默认不显示，右键连接 →Refresh或手动在搜索框输集合名试试 - 查询语句必须是合法 BSON 对象：
{ "status": "active" }✅，{ status: "active" }❌（JS 对象字面量不被接受）
执行聚合或写操作时报错，但 mongosh 里能跑
插件底层用的是 MongoDB Node.js Driver（v6+），它对语法和类型比 mongosh 更严格，尤其涉及 BSON 类型、超大响应或事务上下文时。
-
db.collection.find().toArray()这类链式调用不支持——插件只认原生命令格式，如db.collection.find({}) - 聚合管道里用
$expr或新 BSON 类型（如Decimal128）时，确保驱动版本匹配；VS Code 插件目前基于 Driver v6.7+，低于 v6.3 的语法可能被拒绝 - 写操作（
insertOne、updateMany）需要显式开启：右键集合 →Open Editable View，否则编辑器是只读的 - 返回结果超 1MB 或文档数超 1000 条时，Driver 会截断并静默丢弃，不是插件卡死——加
.limit(100)再试
最容易被忽略的是：插件里所有操作都受限于你登录用户的权限粒度，而不是你本机系统账户；连得上 ≠ 看得见 ≠ 改得了。每次连不上，先切到终端敲 mongosh "mongodb://localhost:27017" 验证通路和权限，再回 VS Code 排查插件侧配置。
