推荐使用 homebrew 安装 mongodb：先装 xcode 命令行工具和 homebrew，再添加 mongodb/brew 源，执行 brew install mongodb-community@8.0 并用 brew services start 启动服务。
一、使用 Homebrew 安装 MongoDB（推荐）
Homebrew 是 macOS 上最主流的包管理工具，安装过程自动化程度高、依赖处理完善，且便于后续版本升级与服务管理。该方式默认安装 MongoDB Community Edition 最新稳定版，并自动配置基础运行环境。
1、确保已安装 Xcode 命令行工具：
在终端中执行 xcode-select --install，按提示完成安装。
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、启动 MongoDB 服务：
推荐启用系统级后台服务：brew services start mongodb-community@8.0。
6、验证服务状态：
运行 brew services list | grep mongodb，确认状态为 started。
二、通过官方 TGZ 包手动安装
此方式适用于需自定义安装路径、规避 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。
三、配置环境变量并启用命令行工具
无论采用哪种安装方式，若需在任意终端位置直接调用 mongod 或 mongosh，必须将 MongoDB 的 bin 目录加入系统 PATH。macOS Catalina 及之后默认使用 zsh，因此需修改 ~/.zshrc。
1、打开 shell 配置文件：
open -e ~/.zshrc。
2、在文件末尾添加以下行（根据实际安装路径调整）：
Homebrew 安装用户添加：export PATH="/opt/homebrew/opt/mongodb-community@8.0/bin:$PATH"；
TGZ 手动安装用户添加：export PATH="/usr/local/mongodb/bin:$PATH"。
3、使配置生效：
source ~/.zshrc。
4、验证命令可用性：
mongod --version 和 mongosh --version 应分别输出版本号。
四、启动 MongoDB Shell 并连接本地实例
MongoDB 6.0 起，mongo 命令已被弃用，统一由独立工具 mongosh 提供交互式 Shell 支持。该工具需单独安装或随新版 Homebrew 安装自动包含。
1、若未安装 mongosh，执行：
brew install mongosh（Homebrew 方式）或
curl -fsSL https://raw.githubusercontent.com/mongodb-js/mongosh/main/install.sh | sudo bash（手动方式）。
2、启动 Shell 并连接默认本地实例：
mongosh "mongodb://127.0.0.1:27017"。
3、在 mongosh 中执行基础操作：
show dbs 列出所有数据库；
use test 切换至 test 数据库；
db.test.insertOne({x: 1}) 插入一条测试文档。
五、配置系统级启动与日志持久化（可选高级设置）
为实现开机自启、日志轮转及进程守护，可创建自定义 launchd 配置文件。该方式绕过 Homebrew Services，适用于对启动行为有精细控制需求的用户。
1、创建 plist 文件：
sudo vim /Library/LaunchDaemons/homebrew.mongodb.plist。
2、填入以下内容（路径需与实际安装一致）：
3、创建配置文件目录与文件：
sudo mkdir -p /usr/local/etc && sudo vim /usr/local/etc/mongod.conf，写入标准 YAML 配置，至少包含：
storage:
dbPath: /usr/local/var/mongodb
systemLog:
destination: file
path: /usr/local/var/log/mongodb/mongo.log
logAppend: true。
4、加载并启动服务：
sudo launchctl load /Library/LaunchDaemons/homebrew.mongodb.plist；
sudo launchctl start homebrew.mongodb。
