Windows 下 MongoDB 安装与配置全攻略
MongoDB 作为一款流行的 NoSQL 数据库,因其灵活性和高性能,被广泛用于 Web 开发、大数据等领域。对于 Windows 用户来说,在本地搭建 MongoDB 环境是学习和项目开发的第一步。本文将手把手带你完成从下载安装到基础配置的全过程,即便你是电脑小白,也能轻松搞定。
一、安装前的准备工作
在开始安装之前,我们需要做好两件事:
1. 确定系统版本
- 右键点击“此电脑”,选择“属性”
- 查看“系统类型”,确认是 64 位还是 32 位系统
- 目前 MongoDB 6.0+ 版本仅支持 64 位系统
2. 下载安装包 访问 MongoDB 官网的下载中心,选择“Community Server”版本。建议选择“Current”稳定版而非“Development”开发版。下载时注意选择正确的 Windows 版本。
二、详细安装步骤
步骤1:运行安装程序
- 找到下载的
.msi安装文件,双击运行 - 如果出现用户账户控制提示,点击“是”
- 安装向导启动后,点击“Next”继续
步骤2:接受许可协议
- 仔细阅读许可条款(虽然大部分人都是直接往下拉)
- 勾选“I accept the terms in the License Agreement”
- 点击“Next”
步骤3:选择安装类型

这里提供两种选择:
- 完整安装:适合大多数用户,点击“Complete”
- 自定义安装:适合需要控制安装路径的用户,点击“Custom”
建议新手选择完整安装,避免配置错误。
步骤4:服务配置(关键步骤)
- 勾选“Install MongoDB as a Service”
- 服务名称保持默认“MongoDB”
- 服务账户选择“Run service as Network Service user”
- 数据目录和日志目录保持默认即可
- 数据目录:
C:\Program Files\MongoDB\Server\{版本号}\data - 日志目录:
C:\Program Files\MongoDB\Server\{版本号}\log
- 数据目录:
步骤5:安装 MongoDB Compass
- 建议勾选“Install MongoDB Compass”
- Compass 是图形化管理工具,对新手非常友好
- 点击“Next”继续
步骤6:开始安装
- 确认安装信息无误
- 点击“Install”开始安装
- 安装过程可能需要几分钟,请耐心等待
步骤7:完成安装
- 安装完成后点击“Finish”
- 如果勾选了安装 Compass,会自动打开 Compass 界面
三、验证安装是否成功
方法1:通过服务验证
- 按
Win + R键,输入services.msc,回车 - 在服务列表中找到“MongoDB”
- 查看状态是否为“正在运行”
- 如果状态是“已停止”,右键点击选择“启动”
方法2:通过命令行验证
- 按
Win + R键,输入cmd,回车打开命令提示符 - 输入以下命令:
mongod --version - 如果显示 MongoDB 版本信息,说明安装成功
方法3:连接测试
- 打开新的命令提示符窗口
- 输入:
mongo - 如果出现 MongoDB 的 shell 提示符(如
>),说明连接成功 - 输入
exit退出
四、基础配置与使用
1. 环境变量配置(可选但推荐)
如果你希望在任意目录都能使用 MongoDB 命令,需要配置环境变量:
- 右键“此电脑” → “属性” → “高级系统设置”
- 点击“环境变量”
- 在“系统变量”中找到“Path”,双击编辑
- 点击“新建”,添加 MongoDB 的 bin 目录路径,例如:
C:\Program Files\MongoDB\Server\{版本号}\bin - 一路点击“确定”保存
2. 创建数据存储目录
虽然安装时已经创建了默认目录,但你可能需要自定义目录:
- 在 D 盘或其他非系统盘创建文件夹,例如:
D:\MongoDBData - 在该文件夹下创建两个子文件夹:
D:\MongoDBData\db # 数据库文件 D:\MongoDBData\log # 日志文件
3. 使用自定义配置启动
- 在
D:\MongoDBData下创建配置文件mongod.cfg - 用记事本打开,输入以下内容:
systemLog: destination: file path: D:\MongoDBData\log\mongod.log logAppend: true storage: dbPath: D:\MongoDBData\db net: bindIp: 127.0.0.1 port: 27017 - 保存文件
4. 以配置文件方式启动服务
- 以管理员身份打开命令提示符
- 停止现有服务(如果正在运行):
net stop MongoDB - 卸载现有服务:
sc delete MongoDB - 重新安装服务并指定配置文件:
mongod --config "D:\MongoDBData\mongod.cfg" --install - 启动服务:
net start MongoDB
五、常见问题解决
问题1:安装时出现“Service MongoDB failed to start”
可能原因:端口被占用或权限不足 解决方案:
- 检查 27017 端口是否被占用:
netstat -ano | findstr :27017 - 如果被占用,要么关闭占用程序,要么修改 MongoDB 端口
- 以管理员身份运行安装程序
问题2:无法连接 MongoDB
可能原因:服务未启动或防火墙阻止 解决方案:
- 检查服务状态(参考第三部分方法1)
- 在防火墙中添加例外:
- 控制面板 → Windows Defender 防火墙 → 允许应用或功能通过防火墙
- 点击“允许其他应用”,找到
mongod.exe
问题3:忘记配置环境变量
症状:在非安装目录下无法使用 mongo 命令
解决方案:
- 每次使用时切换到安装目录的 bin 文件夹
- 或者按第四部分第1点配置环境变量
问题4:磁盘空间不足
症状:数据库无法写入或服务启动失败 解决方案:
- 清理磁盘空间
- 将数据目录迁移到空间充足的磁盘(参考第四部分第2、3点)
六、基础操作入门
1. 启动 MongoDB Shell
mongo
2. 查看数据库列表
show dbs
3. 创建/切换数据库
use mydatabase
如果数据库不存在,MongoDB 会在第一次插入数据时自动创建
4. 创建集合(类似表)
db.createCollection("users")
5. 插入文档(类似行)
db.users.insertOne({
name: "张三",
age: 25,
email: "zhangsan@example.com"
})
6. 查询文档
db.users.find() # 查询所有
db.users.find({name: "张三"}) # 条件查询
七、安全建议
1. 启用身份验证
默认安装的 MongoDB 没有启用身份验证,这在生产环境中是危险的。启用方法:
-
连接 MongoDB:
mongo -
切换到 admin 数据库:
use admin -
创建管理员用户:
db.createUser({ user: "admin", pwd: "你的密码", roles: [ { role: "userAdminAnyDatabase", db: "admin" } ] }) -
修改配置文件,添加:
security: authorization: enabled -
重启 MongoDB 服务
2. 定期备份
mongodump --host localhost --port 27017 --out D:\MongoDBBackup
3. 更新维护
定期检查 MongoDB 官网,及时更新到安全版本。
八、进阶工具推荐
1. MongoDB Compass(官方图形工具)
安装时已包含,提供直观的数据浏览和查询界面。
2. Studio 3T
功能更强大的第三方管理工具,提供 SQL 查询转换等高级功能。
3. Robo 3T
轻量级的开源管理工具,适合资源有限的机器。
九、学习资源推荐
- 官方文档:最权威的学习资料,涵盖所有功能
- MongoDB University:提供免费在线课程
- 中文社区:MongoDB 中文网、CSDN 等技术社区
总结
通过以上步骤,你应该已经在 Windows 系统上成功安装并配置了 MongoDB。记住几个关键点:
- 安装时选择“作为服务安装”可以省去手动启动的麻烦
- 配置环境变量能让后续使用更加方便
- 生产环境一定要启用身份验证
- 定期备份数据,防止意外丢失
MongoDB 的学习曲线相对平缓,从基础操作到高级功能,你可以循序渐进地掌握。如果在安装或使用过程中遇到其他问题,可以查看 MongoDB 的官方文档或在技术社区提问。实践是最好的老师,多动手操作,你会很快掌握这个强大的数据库工具。

还没有评论,来说两句吧...