5分钟上手 MongoDB：从零安装到第一条数据插入（Windows / macOS / Linux 全平台图解）

一、为什么现在就该装 MongoDB？

2025 年的技术栈里，MongoDB 早已不是"可选"而是"标配"：

GitHub 2024 年度报告：NoSQL 关键词提及率 68%，其中 MongoDB 占 47%。
Stack Overflow 2025 调研：全栈开发者最想要的数据库技能，MongoDB 连续三年第一。
云厂商价格战：阿里云、腾讯云、AWS 均推出 0 元起步的 MongoDB Serverless，本地开发环境必须先行。

一句话：今天不装，明天面试被问"ObjectId 是什么"只能尴尬微笑。

二、安装前 30 秒自检

操作系统	最低版本	磁盘预留	端口是否被占
Windows	10 21H2	1 GB	27017
macOS	12 Monterey	1 GB	27017
Linux	Ubuntu 20.04 LTS	1 GB	27017

端口被占？先 netstat -ano | findstr 27017（Win）或 lsof -i :27017（mac/Linux）解决冲突再继续。

三、3 条命令完成本地部署（2025-10 最新 8.0.13 版）

下面所有脚本均已在国内镜像加速，复制即可跑通。

1. Windows（PowerShell 管理员）

powershell 复制代码

# 1. 下载并静默安装
winget install MongoDB.Server --version 8.0.13 -e

# 2. 创建数据目录
mkdir C:\MongoData\db

# 3. 启动服务
mongod --dbpath C:\MongoData\db --logpath C:\MongoData\mongod.log --install
net start MongoDB

安装完成标志：
mongosh 回显 Current Mongosh Version: 2.5.8 即成功。

2. macOS（Homebrew 2025 加速源）

bash 复制代码

# 0. 换清华源（可选，提速 5×）
export HOMEBREW_BOTTLE_DOMAIN=https://mirrors.tuna.tsinghua.edu.cn/homebrew-bottles

# 1. 一键安装
brew install mongodb-community@8.0

# 2. 创建数据目录
sudo mkdir -p /usr/local/var/mongodb
sudo chown $(whoami) /usr/local/var/mongodb

# 3. 前台启动（开发模式）
mongod --dbpath /usr/local/var/mongodb --fork --logpath /usr/local/var/log/mongodb.log

3. Linux（Ubuntu 24.04 示例）

bash 复制代码

# 1. 官方 2025 签名密钥
wget -qO - https://pgp.mongodb.com/server-8.0.asc | sudo gpg --dearmor -o /usr/share/keyrings/mongodb-server-8.0.gpg

# 2. 添加源
echo "deb [ arch=amd64,arm64 signed-by=/usr/share/keyrings/mongodb-server-8.0.gpg ] https://repo.mongodb.org/apt/ubuntu noble/mongodb-org/8.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-8.0.list

# 3. 安装并启动
sudo apt update && sudo apt install -y mongodb-org
sudo systemctl enable --now mongod

四、30 秒验证：插入你的第一条文档

bash 复制代码

mongosh                    # 进入 Shell
use demo                   # 创建并切换数据库
db.users.insertOne({       # 插入文档
  name: "Mongo", age: NumberInt(18), created: new Date()
})
db.users.find().pretty()   # 查询验证

返回类似下方结构即 100% 成功：

json 复制代码

{
  _id: ObjectId("670f5c8a12d7ff04c7e231a3"),
  name: 'Mongo',
  age: 18,
  created: ISODate("2025-10-08T02:36:10.178Z")
}

五、4 个新手必调配置（生产级预览）

配置项	开发默认值	生产建议	命令示例
监听地址	127.0.0.1	0.0.0.0（需鉴权）	`mongod --bind_ip 0.0.0.0`
端口	27017	可保持	`--port 27017`
复制集	未启用	必须启用高可用	`mongod --replSet rs0`
访问控制	未启用	必须创建管理员	`db.createUser({user:"dba",pwd:"***",roles:["userAdminAnyDatabase"]})`

生产环境务必开启 --auth 并配置 TLS，本文从略，后续进阶篇展开。

六、一条龙常用 GUI 工具（2025 免费版）

工具	下载地址	特色
MongoDB Compass	https://www.mongodb.com/try/download/compass	官方出品，支持 Aggregation Pipeline 拖拽
NoSQLBooster 4 MongoDB	https://www.nosqlbooster.com	SQL 转 Mongo、IntelliShell 智能提示
VS Code 插件	插件市场搜索 "MongoDB for VS Code"	直接在编辑器里跑查询，Git 版本追踪脚本

七、5 分钟上手小结

选平台 → 复制 3 条命令 → mongosh 进 Shell → 插入第一条数据。
开发环境先跑起来，再考虑复制集、分片、备份等生产话题。
2025 年 MongoDB 8.0 默认使用 mongosh，老版本 mongo 命令已退役，别再踩坑。

八、下一步读什么？

索引速成：单键、复合、TTL、文本搜索 5 分钟对比
Spring Boot / Node.js / Go 三语言 CRUD 模板仓库（GitHub 2025 星标 TOP10）
Docker Compose 一键启副本集：开发也能玩故障转移

关注作者，回复 "mongo" 获取文中所有脚本与配置文件 GitHub 直达链接。