推荐使用 homebrew 安装 mongodb：先装 xcode 命令行工具和 homebrew，再添加 mongodb/brew 源，执行 brew install mongodb-community@8.0 并用 brew services start 启动服务。
一、使用 Homebrew 安装 MongoDB（推荐）
Homebrew 是 macOS 上最成熟稳定的包管理工具，能自动处理依赖、配置服务及权限，适合大多数用户快速部署 MongoDB Community Edition 最新稳定版。该方式默认安装带完整工具链的官方社区版，并支持系统级服务管理。
1、在终端中执行 xcode-select --install，按提示安装 Xcode 命令行工具。
2、若未安装 Homebrew，运行 /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" 完成安装。
3、添加 MongoDB 官方 Tap 源：brew tap mongodb/brew。
4、安装 MongoDB 社区版（以 8.0 为例）：brew install mongodb-community@8.0。
5、启用后台服务并开机自启：brew services start mongodb-community@8.0。
6、验证服务运行状态：brew services list | grep mongodb，确认显示 started 状态。
二、通过官方 TGZ 包手动安装（路径可控）
此方式将 MongoDB 二进制文件完全置于用户指定目录，不依赖 Homebrew，适用于需规避权限限制、定制数据路径或并行维护多版本的场景。所有组件均保留在本地路径，便于迁移与审计。
1、根据芯片架构下载对应压缩包：Apple Silicon（M1/M2/M3）用户执行 curl -O https://fastdl.mongodb.org/osx/mongodb-macos-aarch64-8.0.3.tgz；Intel 用户执行 curl -O https://fastdl.mongodb.org/osx/mongodb-macos-x86_64-8.0.3.tgz。
2、解压并部署至 /usr/local/mongodb：sudo tar -zxvf mongodb-macos-*.tgz && sudo mv mongodb-macos-* /usr/local/mongodb。
3、创建数据与日志目录：sudo mkdir -p /usr/local/var/mongodb /usr/local/var/log/mongodb。
4、赋予当前用户读写权限（请将 your_username 替换为实际用户名）：sudo chown -R your_username /usr/local/var/mongodb /usr/local/var/log/mongodb。
5、创建空日志文件并授权：sudo touch /usr/local/var/log/mongodb/mongo.log && sudo chown your_username /usr/local/var/log/mongodb/mongo.log。
6、启动 mongod 进程（前台运行）：mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log。
三、配置环境变量与 Shell 工具补全
MongoDB 的命令行工具（如 mongosh）默认不随服务安装，且二进制路径未加入系统 PATH，需手动配置方可全局调用。此步骤确保终端任意位置均可执行 mongosh 或 mongod 命令。
1、编辑 shell 配置文件：nano ~/.zshrc（macOS Catalina 及之后默认使用 zsh）。
2、在文件末尾添加：export PATH="/usr/local/mongodb/bin:$PATH"（若使用 Homebrew 安装，则改为 export PATH="/opt/homebrew/opt/mongodb-community@8.0/bin:$PATH"）。
3、使配置生效：source ~/.zshrc。
4、单独安装 MongoDB Shell（mongosh）：brew install mongosh。
5、验证配置：which mongosh 应返回有效路径，mongosh --version 应输出版本信息。
四、初始化数据目录并启动服务（兼容旧版习惯）
部分用户习惯使用根目录下的 /data/db 作为默认数据路径，MongoDB 在未指定 --dbpath 时会自动查找该路径。此方法无需修改配置文件，适合快速验证或轻量测试。
1、创建标准数据目录：sudo mkdir -p /data/db。
2、赋予当前用户所有权：sudo chown -R $(whoami) /data/db。
3、直接启动 mongod（不带参数）：mongod。
4、另开终端连接：mongosh，进入交互式 Shell。
5、验证数据库可写：use testdb 后执行 db.test.insertOne({x: 1})，成功返回结果即表示写入正常。
五、使用配置文件启动（生产就绪）
通过自定义 mongod.conf 文件可集中管理端口、绑定地址、日志级别、存储引擎等关键参数，避免命令行冗长且易出错，是生产环境或团队协作的标准实践。
1、创建配置目录：sudo mkdir -p /usr/local/etc。
2、生成基础配置文件：echo -e "storage:\n dbPath: /usr/local/var/mongodb\nsystemLog:\n destination: file\n logAppend: true\n path: /usr/local/var/log/mongodb/mongo.log\nnet:\n port: 27017\n bindIp: 127.0.0.1" | sudo tee /usr/local/etc/mongod.conf。
3、确保配置文件权限安全：sudo chown root:wheel /usr/local/etc/mongod.conf。
4、使用配置文件启动（后台运行）：mongod --config /usr/local/etc/mongod.conf --fork。
5、检查进程是否运行：ps aux | grep -v grep | grep mongod，应可见含 --config 参数的进程。
