如果你是mac电脑, 那么你首先想到的安装方式应该是homebrew, 但是有的时候通过Homebrew安装MongoDB会失败了,那么不用担心,本文介绍最可靠的办法是改用手动安装。
这需要你从官网下载压缩包并完成配置。
下面是一个详细的步骤指南,主要基于MongoDB官方文档,并融合了其他实用建议。
整个过程的关键步骤清晰明了,你可以根据自己Mac的芯片类型,在右侧表格中找到对应的操作要点,表格下方则是每个步骤的详细解释和常见问题处理。
| 步骤 | Intel芯片 (x86_64) | Apple Silicon (M系列芯片) |
|---|---|---|
| 1. 下载 | 选择 macOS 平台与 tgz 包。 | 选择 macOS ARM 64 平台与 tgz 包。 |
| 2. 解压 | tar -zxvf mongodb-macos-x86_64-8.0.tgz | tar -zxvf mongodb-macos-arm64-8.0.tgz |
| 3. 设置路径 | 将解压出的bin/目录添加到系统PATH中(推荐方式见下文)。 | 同左。 |
| 4. 创建目录 | 在用户主目录创建~/data/db作为数据存储目录。 | 同左。 |
📦 详细安装与配置步骤
-
下载安装包 访问MongoDB社区版下载中心,在版本下拉框中选择最新版(如8.0),然后根据你的芯片类型,在“Platform”中选择 macOS 或 macOS ARM 64,最后在“Package”中选择 tgz 格式并下载。
-
解压文件 打开终端,进入下载文件所在的目录(通常在
~/Downloads),执行对应的解压命令。# 根据你的芯片类型选择一行执行 tar -zxvf mongodb-macos-x86_64-8.0.tgz # Intel芯片 tar -zxvf mongodb-macos-arm64-8.0.tgz # Apple Silicon芯片解压后会得到一个类似
mongodb-macos-x86_64-8.0的文件夹。 -
配置环境变量 (让系统能找到命令) 为了让终端能直接运行
mongod、mongosh等命令,你需要将MongoDB的可执行文件路径加入系统PATH。- 推荐方法 (创建符号链接):将解压出的
bin目录下的所有命令链接到系统目录(如/usr/local/bin)。# 将 /path/to/the/mongodb-directory/ 替换为你解压出的文件夹的完整路径 sudo ln -s /path/to/the/mongodb-directory/bin/* /usr/local/bin/ - 完成后,可以运行
mongod --version测试是否配置成功。
- 推荐方法 (创建符号链接):将解压出的
-
准备数据与日志目录 MongoDB需要一个目录来存储数据。官方推荐在用户主目录下创建。
# 创建数据目录 mkdir -p ~/data/db # 创建日志目录(可选,但利于排查问题) mkdir -p ~/data/log/mongodb -
启动MongoDB服务 在终端中,使用
--dbpath参数指向你创建的数据目录来启动服务。mongod --dbpath ~/data/db --logpath ~/data/log/mongodb/mongo.log --fork--dbpath: 指定数据目录。--logpath: 指定日志文件路径,方便查看运行状态。--fork: 让服务在后台运行。
-
连接数据库 打开一个新的终端窗口,运行
mongosh命令,即可连接并开始使用MongoDB。mongosh
⚠️ 常见问题与解决
- 启动失败:提示“Address already in use”
这表示默认端口(27017)被占用。可能是之前安装的MongoDB实例未正确关闭。可以先执行
pkill -f mongod终止所有相关进程再启动,或者检查是否有其他程序占用该端口。 - 权限问题
如果启动时提示对
/tmp/mongodb-27017.sock等文件没有权限,可以尝试用sudo chown命令更改文件所有者。 - “command not found: mongo”
从MongoDB 6.0开始,旧的
mongoshell被新的mongosh替代。请确保安装的是mongosh(如果手动安装的tgz包不包含,需要单独下载),并使用mongosh命令连接。
✅ 验证安装成功
在运行mongosh成功连接后,可以执行几个简单的命令来测试:
- 查看当前数据库:
show dbs - 创建一个测试数据库:
use testdb - 插入一条数据:
db.testcollection.insertOne({ name: "Mac User" })如果这些操作都能正常执行,说明你的本地MongoDB服务已经安装并运行成功。
总结来说,手动安装是最直接、可控的备选方案,避免了Homebrew可能出现的复杂依赖或网络问题。只要按照步骤设置好目录和路径,启动过程通常会很顺利。
如果你在安装过程中遇到了上面没有提到的具体错误信息,或者需要了解如何将MongoDB设置为开机自动启动,我可以提供更详细的帮助。