MongoDB Community Server 安装教程

很多同学在本地开发时都会遇到数据库环境配置的难题，尤其是 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 已经成功安装并运行了。接下来就可以开始你的本地开发之旅了。