MongoDB Community Server 安装教程
针对macOS(Homebrew)、Windows(MSI)及Ubuntu(apt)分别介绍MongoDBCommunityServer安装方法。安装后启动服务并进入mongosh验证数据库运行,确保配置正确。
很多同学在本地开发时都会遇到数据库环境配置的难题,尤其是 MongoDB,版本迭代快、安装方式也多,稍不注意就容易踩坑。这篇教程就把主流操作系统(macOS、Windows、Ubuntu)下的安装步骤梳理清楚,跟着走就能搞定一个可用的 MongoDB Community Server 环境。文末还附了常用命令和简单测试方法,方便验证安装结果。

macOS 安装:推荐 Homebrew
如果你用的是 Mac,Homebrew 是最省事的安装方式。先确认一下是否已经装了 Homebrew,没装的话在终端执行下面这条命令:
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
然后添加 MongoDB 官方的 Homebrew 源:
brew tap mongodb/brew
接下来安装 MongoDB Community(以 8.0 版本为例):
brew install mongodb-community@8.0
安装完成后,用 Homebrew 启动 MongoDB 服务:
brew services start mongodb-community@8.0
可以用这条命令检查服务是否正常运行:
brew services list
启动成功后,在终端输入 mongosh 进入 MongoDB Shell:
mongosh
如果看到 test> 这样的提示符,就说明 MongoDB 已经跑起来了。
Windows 安装
Windows 用户直接到下载页(https://www.mongodb.com/try/download/community)获取安装包。参数按下面选:
- Version:默认最新稳定版即可
- Platform:Windows
- Package:MSI
下载完双击 .msi 安装包。安装向导里注意几个关键选项:
- 安装方式选 Complete(完整安装)
- 勾选 Install MongoDB as a Service(作为服务安装,自动后台运行)
- 建议勾选安装 MongoDB Compass——这是官方的图形化管理工具,对新手很友好
安装完成后打开命令行(CMD 或 PowerShell),输入 mongosh。如果提示找不到该命令,说明 MongoDB Shell 没自动装上,需要单独下载安装:https://www.mongodb.com/try/download/shell
同样,看到 test> 提示符就说明安装成功。
Ubuntu 安装(MongoDB 8.0 示例)
Linux 用户(以 Ubuntu 为例)需要走 apt 源安装。先安装依赖工具:
sudo apt-get install gnupg curl
导入 MongoDB 的 GPG 公钥:
curl -fsSL https://pgp.mongodb.com/server-8.0.asc | sudo gpg -o /usr/share/keyrings/mongodb-server-8.0.gpg --dearmor
如果你是 Ubuntu 22.04,执行下面这条命令添加源:
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list
更新包列表并安装:
sudo apt-get update sudo apt-get install -y mongodb-org
安装完成后,启动 MongoDB 服务:
sudo systemctl start mongod
设置开机自启:
sudo systemctl enable mongod
最后同样用 mongosh 测试连接。
常用命令速查
安装完成后,日常运维中可能会用到的几个命令,这里一并整理:
# macOS 启动 brew services start mongodb-community@8.0 # macOS 停止 brew services stop mongodb-community@8.0 # Linux 启动 sudo systemctl start mongod # Linux 停止 sudo systemctl stop mongod # 进入 MongoDB 交互 Shell mongosh
简单测试:验证安装是否成功
进入 mongosh 后,可以执行以下命令做一次快速验证:
use testdb
db.users.insertOne({ name: "Tom", age: 18 })
db.users.find()
如果能正常插入数据并查询到刚刚插入的记录,就说明 MongoDB 已经成功安装并运行了。接下来就可以开始你的本地开发之旅了。
