macOS 配 MongoDB 有 Homebrew 和手动两种方式:前者自动处理依赖与自启,适合日常开发;后者路径自主、支持多版本,适合 Apple Silicon 用户或需精细控制场景。

在 macOS 上配好本地 MongoDB 环境,核心就三步:装好服务、设好路径、连得上库。现在主流用 Homebrew 安装最省心,手动安装则更可控——选哪种,取决于你是否需要多版本共存或绕过系统权限限制。
用 Homebrew 快速安装并启动服务
这是当前(2026 年)最推荐的方式,自动处理依赖、日志、开机自启,适合日常开发。
- 先装 Xcode 命令行工具:
xcode-select --install - 没装 Homebrew 就运行:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" - 添加官方源并安装最新稳定版(如 8.0):
brew tap mongodb/brew && brew install mongodb-community@8.0 - 启动服务并设为开机自启:
brew services start mongodb-community@8.0 - 检查是否运行中:
brew services list | grep mongodb,看到 started 即成功
手动安装(解压即用,路径完全自主)
适合 M1/M2/M3 芯片用户,或想把 MongoDB 放在非默认位置、同时管理多个版本的人。
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac,无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启:辅助功能 + 屏幕录制权限
- 按芯片下载对应包:
Apple Silicon: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 - 解压并移入指定目录(如
/usr/local/mongodb):tar -zxvf mongodb-macos-*.tgz && sudo mv mongodb-macos-* /usr/local/mongodb - 建数据与日志目录:
mkdir -p /usr/local/var/mongodb /usr/local/var/log/mongodb - 改权限(把
your_username换成你终端里whoami输出的名字):sudo chown -R your_username /usr/local/var/mongodb /usr/local/var/log/mongodb - 启动服务(前台运行,方便调试):
mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log
配置环境变量,让命令全局可用
无论哪种安装方式,mongosh(新版 Shell)和 mongod 默认都不在 PATH 里,必须手动加。
- 打开终端配置文件:
vim ~/.zshrc(macOS Catalina 及之后默认用 zsh) - 末尾追加一行(Homebrew 安装路径示例):
export PATH="/opt/homebrew/opt/mongodb-community@8.0/bin:$PATH"
手动安装则写:export PATH="/usr/local/mongodb/bin:$PATH" - 生效配置:
source ~/.zshrc - 验证:
mongosh --version或mongod --version能输出版本号即成功
连接数据库并简单测试
服务跑起来后,新开一个终端窗口操作即可,不用关掉原服务进程。
- 启动客户端:
mongosh(不是旧版mongo,已弃用) - 连本地默认实例:
mongosh "mongodb://127.0.0.1:27017" - 进 shell 后试试:
show dbs查看已有数据库;use mytest切换或创建新库;db.test.insertOne({x:1})写一条数据 - 浏览器访问 https://www.php.cn/link/c7b3204ec9bfea0a9f9dc23b77f3b5e7,看到“It looks like you are trying to access MongoDB over HTTP…”说明端口通了










