3. 开发环境与工具链搭建

MongoDB 企业级应用开发的第一步，不是写业务代码，而是把“能连上、能看见、能调试”的环境搭起来。本节围绕 MongoDB Community/Enterprise 安装、mongosh、Compass、VS Code 插件、Docker 与连接字符串配置展开，目标是让读者在一台开发机上形成一条完整的工具链：数据库进程可运行、命令行可查询、图形界面可观察、代码编辑器可调试、容器可复现、连接字符串可复用。

一、安装方式的选择：Community 与 Enterprise

MongoDB 提供 Community 与 Enterprise 两个版本。Community 是免费开源版本，适合学习、开发与中小规模部署；Enterprise 在 Community 基础上增加了审计、LDAP/Kerberos 认证、加密存储引擎、Ops Manager 集成等企业级能力。开发阶段通常先用 Community 完成功能验证，若项目明确要求企业安全合规，再切换到 Enterprise 进行联调。

在 Windows 上，推荐使用 MSI 安装包，安装时选择“Complete”并勾选“Install MongoDB as a Service”，这样系统会自动注册为 Windows 服务，默认监听 127.0.0.1:27017。在 macOS 上，可通过 Homebrew 安装：

brew tap mongodb/brew
brew install mongodb-community@7.0
brew services start mongodb-community@7.0

在 Ubuntu 上，先导入官方 GPG 密钥并添加软件源，再安装：

sudo apt-get install -y mongodb-org
sudo systemctl start mongod
sudo systemctl enable mongod

安装完成后，用 mongod --version 确认版本，用 systemctl status mongod 或 brew services list 确认服务状态。若服务未启动，优先检查数据目录权限与端口占用，而不是反复重装。

二、mongosh：命令行交互与脚本化

mongosh 是 MongoDB 官方推荐的现代 Shell，替代了旧的 mongo 命令。它支持 JavaScript 语法、语法高亮、自动补全和异步操作。启动方式很简单：

mongosh "mongodb://localhost:27017"

进入后可以执行 show dbs、use shop、db.orders.insertOne({...}) 等命令。mongosh 的价值不仅在于交互查询，还在于它可以加载外部脚本，用于初始化测试数据或执行批量校验：

mongosh "mongodb://localhost:27017/shop" --file init-data.js

在开发阶段，建议把常用的初始化脚本、索引创建脚本、测试数据脚本统一放在项目的 scripts/ 目录下，通过 mongosh 执行，避免手工重复操作。

三、Compass：可视化观察与索引分析

Compass 是 MongoDB 官方图形化客户端，适合做数据浏览、查询构建、索引分析和性能观察。连接时填入连接字符串即可，例如 mongodb://localhost:27017。Compass 中最值得开发阶段使用的功能有三个：一是文档浏览与内嵌文档展开，便于确认数据结构；二是 Explain Plan 可视化，能直观看到查询是否命中索引；三是 Schema 分析，能快速识别字段类型分布与缺失情况。

例如，当你在 Compass 中对 orders 集合按 customerId 查询时，如果 Explain Plan 显示 COLLSCAN，说明没有命中索引，应检查是否缺少 { customerId: 1 } 索引。Compass 把抽象的查询计划变成了可读的树形结构，这是纯命令行不容易快速做到的。

四、VS Code 插件与 Docker 环境

在 VS Code 中，推荐安装 MongoDB 官方插件“MongoDB for VS Code”。它可以在编辑器内直接连接数据库、浏览集合、执行查询、创建 Playground 脚本。Playground 文件以 .mongodb.js 结尾，可以像写代码一样写查询并即时运行，非常适合把调试过程沉淀为可复用的脚本。

Docker 则解决“环境一致性”问题。用一条命令即可启动一个带认证的 MongoDB 容器：

docker run -d --name mongo-dev \
  -p 27017:27017 \
  -e MONGO_INITDB_ROOT_USERNAME=admin \
  -e MONGO_INITDB_ROOT_PASSWORD=Passw0rd \
  mongo:7.0

如果希望数据持久化，再加上 -v mongo-data:/data/db。团队协作时，把这段命令写进 docker-compose.yml，新成员只需 docker compose up -d 就能获得一致的数据库环境。

五、连接字符串配置：把工具串起来

连接字符串是工具链的“接口”。标准格式为：

mongodb://[username:password@]host[:port][/database][?options]

开发环境常用示例：

mongodb://admin:Passw0rd@localhost:27017/shop?authSource=admin

其中 authSource=admin 表示认证库为 admin，这是使用 root 用户时最容易遗漏的参数。若使用副本集，则写成 mongodb://host1:27017,host2:27017,host3:27017/shop?replicaSet=rs0。生产环境建议使用 mongodb+srv:// 形式，由 DNS SRV 记录自动发现节点。

配置连接字符串时，建议遵循三条原则：第一，用户名密码不要硬编码在代码里，使用环境变量或配置中心；第二，开发、测试、生产使用不同的数据库名与认证库；第三，连接参数如 retryWrites=true&w=majority 要显式写出，避免依赖默认值导致行为不一致。

六、环境验证与常见问题

工具链搭好后，建议按以下顺序验证：第一步，用 mongosh 连接并执行 db.runCommand({ ping: 1 })，返回 { ok: 1 } 说明服务与认证正常；第二步，在 Compass 中连接同一字符串，确认能看到数据库列表；第三步，在 VS Code Playground 中执行一次查询，确认插件连接正常；第四步，用应用代码通过驱动连接，执行一次插入与查询。

常见问题中，Authentication failed 多数是 authSource 写错；ECONNREFUSED 多数是服务未启动或端口未映射；Docker 中容器启动后立即退出，通常是数据目录权限或初始化脚本报错，可用 docker logs mongo-dev 查看。把这些判断依据记下来，后续排障会快很多。