一、环境准备：确保系统兼容性

在Mac系统上安装MongoDB前，需确认系统环境满足以下条件：

1. 操作系统版本：支持macOS 10.13（High Sierra）及以上版本，推荐使用最新稳定版macOS（如Ventura或Sonoma）。可通过点击左上角苹果图标→”关于本机”查看系统版本。
2. 硬件要求：建议至少4GB内存（生产环境推荐8GB+），预留10GB以上磁盘空间。MongoDB默认数据存储路径为/data/db，需确保该目录有足够空间。
3. 依赖工具：需安装Homebrew包管理器（用于简化安装流程）。若未安装，可通过终端执行：

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

4. 终端工具：推荐使用iTerm2（支持分屏、历史搜索等高级功能），替代系统自带终端。

二、安装MongoDB：三种主流方法对比

方法1：通过Homebrew安装（推荐）

1. 更新Homebrew仓库：

   brew update

2. 搜索MongoDB版本：

   brew search mongodb
   # 输出示例：
   # mongodb-community   # 官方社区版
   # mongodb-community@6.0  # 指定版本

3. 安装社区版（默认最新稳定版）：

   brew install mongodb-community

4. 安装指定版本（如6.0）：

   brew install mongodb-community@6.0

   优势：自动处理依赖关系，支持版本切换，便于升级维护。

方法2：手动下载安装包

1. 访问MongoDB官网下载页面，选择macOS平台。
2. 下载.tgz压缩包（如mongodb-macos-x86_64-6.0.6.tgz）。
3. 解压到指定目录：

   tar -xzvf mongodb-macos-x86_64-6.0.6.tgz -C /usr/local/

4. 配置环境变量：

   echo 'export PATH="/usr/local/mongodb-macos-x86_64-6.0.6/bin:$PATH"' >> ~/.zshrc
   source ~/.zshrc

   适用场景：需要完全控制安装路径或使用非Homebrew管理的环境。

方法3：使用Docker容器（开发测试优选）

1. 安装Docker Desktop for Mac（从官网下载）。
2. 拉取MongoDB镜像：

   docker pull mongo:6.0

3. 启动容器：

   docker run --name mongodb -p 27017:27017 -v ~/data/db:/data/db -d mongo:6.0

   优势：隔离运行环境，快速部署多版本，适合团队协作。

三、配置MongoDB：关键参数设置

1. 数据存储目录配置

默认情况下，MongoDB需要/data/db目录。若需自定义路径：

1. 创建目录：

   mkdir -p ~/mongodb/data

2. 启动时指定路径：

   mongod --dbpath ~/mongodb/data

2. 配置文件（mongod.conf）

1. 创建配置文件：

   touch ~/mongodb/mongod.conf

2. 编辑配置（示例）：

   storage:
   dbPath: ~/mongodb/data
   journal:
    enabled: true
   net:
   bindIp: 127.0.0.1  # 仅本地访问
   port: 27017
   systemLog:
   destination: file
   path: ~/mongodb/mongod.log
   logAppend: true

3. 启动时引用配置：

   mongod --config ~/mongodb/mongod.conf

3. 用户认证配置（生产环境必需）

1. 启动时启用认证：

   mongod --auth --port 27017 --dbpath ~/mongodb/data

2. 进入admin数据库创建用户：

   use admin
   db.createUser({
   user: "adminUser",
   pwd: "securePassword123",
   roles: ["root"]
   })

3. 后续连接需添加认证参数：

   mongo --username adminUser --password securePassword123 --authenticationDatabase admin

四、启动与停止：操作指南

启动方式

1. 直接启动：

   mongod --dbpath ~/mongodb/data

2. 使用Homebrew服务（推荐）：

   brew services start mongodb-community
   # 查看状态
   brew services list

3. 后台运行（添加--fork参数）：

   mongod --dbpath ~/mongodb/data --fork --logpath ~/mongodb/mongod.log

停止方式

1. 正常停止：
   • 连接MongoDB后执行：

     use admin
     db.shutdownServer()

2. 强制停止（不推荐）：

   kill $(ps aux | grep 'mongod' | grep -v grep | awk '{print $2}')

3. 通过Homebrew停止：

   brew services stop mongodb-community

五、验证安装：连接测试

1. 启动MongoDB后，在终端执行：

   mongo

2. 成功连接后应显示：

   > show dbs
   admin   0.000GB
   config  0.000GB
   local   0.000GB

3. 测试写入数据：

   use test
   db.testCollection.insertOne({name: "MacMongoDB", status: "running"})
   db.testCollection.find()

六、常见问题解决方案

1. 端口占用错误：
   • 错误提示：Address already in use
   • 解决方案：

     lsof -i :27017
     kill -9 <PID>

2. 权限不足错误：
   • 错误提示：Permission denied
   • 解决方案：

     sudo chown -R $(whoami) ~/mongodb/data

3. 版本冲突：
   • 现象：Homebrew安装失败
   • 解决方案：

     brew uninstall mongodb-community
     brew cleanup
     brew install mongodb-community

七、最佳实践建议

1. 数据备份：定期执行mongodump：

   mongodump --out ~/mongodb/backup --db test

2. 性能监控：使用mongostat工具：

   mongostat --port 27017

3. 日志分析：配置systemLog.logRotate参数实现日志轮转。
4. 版本升级：通过Homebrew升级时，先备份数据：

   brew upgrade mongodb-community

本文系统梳理了Mac系统下MongoDB从安装到运维的全流程，涵盖Homebrew安装、配置优化、启动停止等核心操作，并提供了故障排查指南。建议开发者根据实际需求选择安装方式，生产环境务必配置认证和备份机制。