1/使用 Homebrew 安装(推荐)
步骤 1:安装 Homebrew(如果尚未安装)
# 打开终端(Terminal)
# 安装 Homebrew
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
# 添加 Homebrew 到 PATH(根据安装完成后的提示操作)
echo 'eval "$(/opt/homebrew/bin/brew shellenv)"' >> ~/.zshrc
source ~/.zshrc
# 验证安装
brew --version
步骤 2:添加 MongoDB 仓库并安装
# 添加 MongoDB 的 Homebrew 仓库
brew tap mongodb/brew
# 更新 Homebrew
brew update
# 安装 MongoDB Community Edition
brew install mongodb-community
# 或者安装特定版本(可选)
# brew install mongodb-community@6.0
步骤 3:创建必要目录
# 创建数据存储目录
sudo mkdir -p /usr/local/var/mongodb
# 创建日志目录
sudo mkdir -p /usr/local/var/log/mongodb
# 设置目录权限(使用你的用户名替换 YOUR_USERNAME)
sudo chown -R $(whoami) /usr/local/var/mongodb
sudo chown -R $(whoami) /usr/local/var/log/mongodb
步骤 4:启动 MongoDB 服务
# 方法A:使用 Homebrew Services(推荐,自动启动)
brew services start mongodb-community
# 方法B:手动启动
mongod --config /usr/local/etc/mongod.conf
# 方法C:使用自定义配置启动
mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log --fork
步骤 5:验证安装和运行状态
# 检查服务状态
brew services list | grep mongo
# 连接到 MongoDB
mongosh
# 或者使用旧版 mongo shell(如果已安装)
# mongo
# 在 MongoDB shell 中运行测试命令
> db.runCommand({ ping: 1 })
# 应该返回:{ "ok": 1 }
2/常用命令和操作
(1)基本操作
# 连接到 MongoDB
mongosh
# 查看数据库
show dbs
# 使用数据库
use test
# 查看集合
show collections
# 创建集合
db.createCollection("users")
# 插入文档
db.users.insertOne({name: "John", age: 30})
# 查询文档
db.users.find()
(2)服务管理命令
# 停止 MongoDB
brew services stop mongodb-community
# 重启 MongoDB
brew services restart mongodb-community
# 查看日志
tail -f /usr/local/var/log/mongodb/mongo.log
# 停止 MongoDB 进程
mongod --shutdown
(3)故障排除
# 如果遇到端口占用
sudo lsof -i :27017
sudo kill -9 <PID>
# 修复权限问题
sudo chown -R $(whoami):admin /data/db
# 查看 MongoDB 版本
mongod --version
# 重置数据库(谨慎使用)
rm -rf /data/db/*
(4)安装 MongoDB Compass(图形界面)
# 使用 Homebrew 安装 Compass
brew install --cask mongodb-compass
# 或从官网下载:https://www.mongodb.com/products/compass
(5)配置环境变量
# 添加到 ~/.zshrc 或 ~/.bash_profile
echo 'export PATH="/usr/local/opt/mongodb-community/bin:$PATH"' >> ~/.zshrc
echo 'export MONGO_PATH=/usr/local/mongodb' >> ~/.zshrc
echo 'export PATH=$PATH:$MONGO_PATH/bin' >> ~/.zshrc
# 重新加载配置
source ~/.zshrc
(6)验证安装完成
# 运行验证脚本
echo "=== MongoDB 安装验证 ==="
echo "1. 检查服务状态:"
brew services list | grep mongo
echo "\n2. 检查版本:"
mongod --version | head -3
echo "\n3. 测试连接:"
mongosh --eval "db.runCommand({ ping: 1 })"
echo "\n4. 检查进程:"
ps aux | grep mongod | grep -v grep
3/注意事项
- 数据备份:定期备份
/data/db或/usr/local/var/mongodb目录 - 安全配置:生产环境需要配置认证
- 内存使用:MongoDB 会尽可能使用可用内存
- 版本兼容:确保客户端驱动与服务器版本兼容
- 磁盘空间:确保有足够的磁盘空间供数据库使用
4/卸载 MongoDB
# 如果使用 Homebrew 安装
brew services stop mongodb-community
brew uninstall mongodb-community
brew untap mongodb/brew
# 删除数据目录(谨慎操作)
sudo rm -rf /data/db
sudo rm -rf /usr/local/var/mongodb
现在你已经成功在 macOS 上安装并启动了 MongoDB 服务!可以使用 mongosh 连接到数据库开始使用了。