本文详细介绍在 Mac OSX 系统上安装 MongoDB 的两种主流方法：手动下载安装包与使用 Homebrew 安装。涵盖从下载官方安装包、配置环境变量、创建数据日志目录，到启动服务及验证运行的完整步骤。同时提供 Homebrew 安装方式的命令与配置路径说明，帮助用户快速搭建本地 MongoDB 开发环境。
安装结果预览
成功安装并启动 MongoDB 后，你将能够通过命令行工具连接数据库，执行基本的查询和写入操作。以下是安装完成后的关键状态示意：
如图所示，访问 MongoDB 官方下载页面后，选择 Community Server 并选择对应的 macOS 版本进行下载。这是手动安装的第一步。
前置条件与准备
在开始安装之前，请确保你的 Mac 系统满足以下要求：
- 操作系统：macOS 10.7 (Lion) 或更高版本（MongoDB 3.0+ 版本要求）。
- 权限：需要管理员权限（sudo）来安装软件和修改系统目录。
- 网络：能够访问互联网以下载安装包或 Homebrew 软件源。
建议在执行安装前，备份重要数据，并关闭可能占用端口 27017 的其他数据库服务。
方案一：手动下载安装与配置
手动安装提供了对安装路径和版本的完全控制，适合需要特定版本或自定义配置的高级用户。
第1步：下载 MongoDB 安装包
访问 MongoDB 官方下载页面，选择 Community Server，操作系统选择 macOS，版本选择最新的稳定版（如 4.4.x 或 6.0.x），架构选择 x86_64 或 arm64（Apple Silicon 芯片）。
下载完成后，你会得到一个 .tgz 格式的压缩文件。
第2步：解压并移动至系统目录
打开终端（Terminal），执行以下命令将下载的文件解压并移动到 /usr/local 目录下，命名为 mongodb。
# 进入 /usr/local 目录
cd /usr/local
# 解压下载的文件（请将文件名替换为你实际下载的版本）
sudo tar -zxvf mongodb-osx-ssl-x86_64-*.tgz
# 将解压后的目录重命名为 mongodb
sudo mv mongodb-osx-x86_64-* mongodb执行完毕后，/usr/local/mongodb 目录下应包含 bin、etc、man 等子目录。
第3步：配置环境变量
为了能在终端任意位置直接调用 mongod 和 mongo 命令，需要将 MongoDB 的 bin 目录添加到系统环境变量 PATH 中。
# 编辑 ~/.bash_profile 或 ~/.zshrc 文件
nano ~/.zshrc # 如果使用 zsh（macOS Catalina 及以后默认）
# 或者
nano ~/.bash_profile # 如果使用 bash在文件末尾添加以下行：
export PATH=/usr/local/mongodb/bin:$PATH保存并退出编辑器后，执行以下命令使配置立即生效：
source ~/.zshrc # 或 source ~/.bash_profile第4步：创建数据与日志目录
MongoDB 默认将数据存储在 /data/db 目录，日志存储在 /var/log/mongodb/usr/local/var 下创建专用目录。
# 创建数据目录
sudo mkdir -p /usr/local/var/mongodb
# 创建日志目录
sudo mkdir -p /usr/local/var/log/mongodb第5步：设置目录权限
确保当前登录用户拥有对数据目录和日志目录的读写权限。请将 your_username 替换为你的 Mac 用户名（可通过终端输入 whoami 查看）。
# 修改数据目录所有者
sudo chown -R your_username /usr/local/var/mongodb
# 修改日志目录所有者
sudo chown -R your_username /usr/local/var/log/mongodb第6步：启动 MongoDB 服务
使用 mongod 命令启动数据库服务。指定数据路径、日志路径，并使用 --fork 参数在后台运行。
mongod --dbpath /usr/local/var/mongodb --logpath /usr/local/var/log/mongodb/mongo.log --fork如果启动成功，终端将返回 about to fork child process, waiting until server is ready for connections. 以及 forked process: [PID] 等信息。
第7步：验证安装与连接
打开一个新的终端窗口，进入 MongoDB 的 bin 目录，启动 MongoDB Shell。
cd /usr/local/mongodb/bin
./mongo如果连接成功，你将看到类似以下的输出：
connecting to: mongodb://127.0.0.1:27017
MongoDB server version: 4.x.x
>此时，你可以尝试执行一个简单的计算或数据库操作来验证：
> db.version()
> 1 + 1如果返回版本号及计算结果 2，则说明安装成功。
方案二：使用 Homebrew 安装（推荐）
Homebrew 是 macOS 上流行的包管理器，使用它可以更轻松地安装、更新和管理 MongoDB。
第1步：添加 MongoDB 官方 Tap
首先，将 MongoDB 的官方软件源添加到 Homebrew：
brew tap mongodb/brew第2步：安装 MongoDB 社区版
安装最新推荐的稳定版本（例如 4.4 或 6.0，具体版本号请以 Homebrew 提示为准）：
brew install mongodb-community@4.4安装完成后，Homebrew 会显示配置文件、日志和数据目录的路径，通常如下：
- 配置文件：
/usr/local/etc/mongod.conf - 日志目录：
/usr/local/var/log/mongodb - 数据目录：
/usr/local/var/mongodb
第3步：启动 MongoDB 服务
使用 Homebrew 的服务管理命令启动 MongoDB：
brew services start mongodb-community@4.4若要停止服务，可执行：
brew services stop mongodb-community@4.4或者，你也可以直接使用 mongod 命令并指定配置文件来启动：
mongod --config /usr/local/etc/mongod.conf --fork第4步：验证服务状态
检查 MongoDB 进程是否正在运行：
ps aux | grep -v grep | grep mongod如果看到 mongod 进程信息，说明服务已启动。
常见问题与调整
问题1：权限被拒绝（Permission Denied）
表现：启动 mongod 时提示无法创建数据目录或日志文件。
原因：当前用户没有对 /usr/local/var/mongodb 或日志目录的写入权限。
解决：使用 sudo chown -R $(whoami) /usr/local/var/mongodb 修正目录所有者。
问题2：端口被占用（Address already in use）
表现：启动服务时报错 port already in use。
原因：端口 27017 已被其他 MongoDB 实例或数据库服务占用。
解决：使用 lsof -i :27017 查找占用端口的进程，并使用 kill -9 [PID] 终止旧进程后重新启动。
问题3：MongoDB Shell 缺失（v6.0+）
表现：执行 mongo 命令提示找不到命令。
原因：MongoDB 6.0 及更高版本默认不再包含 mongo shell 工具。
解决：需要单独安装 MongoDB Shell。使用 Homebrew 安装：brew install mongodb-shell，然后使用 mongosh 命令连接数据库。
总结
在 Mac OSX 上安装 MongoDB 主要有两种途径：手动下载安装包适合需要精细控制安装路径和版本的用户；而使用 Homebrew 则更加便捷，适合大多数开发者和初学者。无论选择哪种方式，确保数据目录和日志目录权限正确、环境变量配置无误是成功运行的关键。安装完成后，建议定期备份数据，并根据实际需求调整 mongod.conf 配置文件中的内存、日志轮转等参数。
以上就是 Mac OSX 平台安装 MongoDB 的详细内容，更多关于 MongoDB 配置与优化的资料请关注本站其它相关文章！
