常见原因是插件仅是客户端，需先运行mongod实例；检查进程、端口27017、连接字符串格式（含协议头）、认证信息及权限配置。
VSCode里装了MongoDB插件但连不上数据库，常见原因是什么
插件本身不自带 MongoDB 服务，它只是个客户端界面；你得先确保本地或远程有真实运行的 mongod 实例，且网络可达。很多人卡在这一步，以为装完插件就能连，结果点“Connect”一直转圈或报 Connection refused。
- 检查
mongod进程是否在运行：ps aux | grep mongod（macOS/Linux）或任务管理器（Windows） - 默认端口是
27017，如果改过，连接字符串里必须显式写上:27017或对应端口 - 本地连接用
mongodb://localhost:27017，别漏协议头；远程连接要确认防火墙、MongoDB 的bindIp配置是否允许外部访问 - 如果启用了认证，连接字符串得带用户名密码，格式为
mongodb://user:pass@host:port，且用户必须有对应数据库的readWrite或更高权限
MongoDB for VS Code 插件里怎么正确填写连接字符串
连接字符串不是随便填个 IP 就行，插件对格式敏感，错一个字符就解析失败，提示 Invalid connection string 或直接无响应。
- 最简可用格式：
mongodb://localhost:27017（无认证、本地默认配置） - 带认证时，注意 URL 编码：如果密码含
/、@、:等特殊字符，必须用encodeURIComponent()处理，比如密码pa@ss/word要写成pa%40ss%2Fword - 指定数据库名可加在末尾：
mongodb://localhost:27017/mydb，这样打开后默认进该库，但不影响连接本身 - 不要加多余空格，尤其在冒号、斜杠前后；插件不会自动 trim
连接成功后看不到集合，或者点开集合查不出数据
这通常不是插件问题，而是权限或视图配置导致的“看不见”。
- 默认连接用的是
admin数据库认证，但插件浏览的是你连接字符串末尾指定的库（或test），如果用户没被授权访问那个库，集合列表就是空的 - 检查用户权限：用
mongoshell 连上去，执行db.runCommand({connectionStatus: 1})看authInfo.db和authenticatedUsers - 集合名带前缀（如
system.）或以数字开头的，插件可能默认隐藏；可以右键“Refresh”或手动输入集合名搜索 - 查询语句必须是合法的 BSON 对象，比如
{ "name": "Alice" }可以，{ name: "Alice" }（没引号）会报Unexpected token
执行查询后返回结果乱码、字段缺失或超时
插件底层调用的是 MongoDB Node.js Driver，它对 BSON 类型和响应大小有限制，不是所有 shell 里能跑的语法都支持。
- 时间字段（
Date、ObjectId）会自动转成字符串显示，不是 bug，是序列化行为；想看原始值得导出 JSON 或用mongoshell - 结果默认只取前 50 条，想查看更多，点击右下角的
Load more，或者在查询对象里加$limit显式控制 - 复杂聚合管道（
$lookup、$facet）可能因 driver 版本不匹配报错，插件目前基于较新 driver，老版本 MongoDB（如 3.6 以下）不完全兼容 - 超时通常是网络或查询未建索引导致，插件默认 30 秒超时，没法改；大集合务必先在 shell 里用
explain("executionStats")看性能
MongoDB 插件省事，但绕不开权限、连接串细节和 driver 兼容性这些硬约束；最常被忽略的是——它根本不会告诉你认证失败和网络不通的区别，两个都只显示“连接失败”。
