MongoDB 安装 Windows:新手也能一次装对的完整教程
问题分析
MongoDB 是很多开发、测试、学习场景里常用的数据库。Windows 上安装 MongoDB 并不难,但新手经常卡在这几个地方:
- 下载版本选错,装完服务起不来。
- 没有正确配置环境变量,命令行里无法直接使用
mongod、mongosh。 - 数据目录没建好,启动时提示找不到路径。
- 没装 MongoDB Compass,导致不会查看数据库内容。
- 服务模式和手动启动混在一起,后面排错很麻烦。
如果目标是“装好、能启动、能连接、能长期稳定使用”,就要按正确顺序来。
解决方案
一、先确定你要装的是什么
MongoDB 在 Windows 上通常要装这几个组件:
- MongoDB Community Server:数据库服务本体,必须装。
- MongoDB Shell(mongosh):命令行操作工具,建议装。
- MongoDB Compass:图形化管理工具,适合新手,建议装。
如果你是刚接触数据库,建议直接把这三个都装上,省得后面补装。
二、下载 MongoDB 安装包
- 打开 MongoDB 官方下载页面。
- 选择:
- Platform:Windows
- Package:msi
- Version:建议选稳定版,不要追最新测试版
- 下载完成后,双击安装包开始安装。
版本建议
- Windows 10 / Windows 11:优先装当前稳定版。
- 老旧电脑或老系统:尽量别追高版本,优先保证兼容性。
- 学习和开发环境:一般用 Community Server 就够了。
三、安装时怎么选
安装界面里重点关注这几个选项:
1. 选择 Complete 安装
推荐选 Complete,它会把常用组件一起装上,省事。
2. 勾选 Install MongoDB as a Service
这个选项很重要。
勾选后,MongoDB 会作为 Windows 服务运行,开机可自动启动,后续使用更稳定。
如果你只是临时测试,也可以不勾,但对新手来说,建议勾选。
3. Service Name 保持默认
一般默认就行,不要随便改,避免后续服务名对不上。
4. 勾选 Install MongoDB Compass
如果安装界面提供 Compass,建议一起装。
它能让你不用全靠命令行就能看数据、建库、查表。
四、手动创建数据目录
MongoDB 启动时需要一个存放数据库文件的目录,Windows 下常见默认路径是:
C:\data\db
如果这个目录不存在,MongoDB 可能启动失败。
建议操作
- 打开“此电脑”
- 进入
C:盘 - 新建文件夹
data - 在
data里面再建一个db
最终路径是:
C:\data\db
如果你想自定义目录,也可以,比如:
D:\mongodb\data\db
但前提是后面启动时要写对路径。
五、配置环境变量
安装完后,建议把 MongoDB 的 bin 目录加入环境变量,这样在命令行里可以直接输入命令。
常见路径
MongoDB 默认安装后,bin 目录通常类似:
C:\Program Files\MongoDB\Server\8.0\bin
具体版本号可能不同,比如 7.0、6.0。
配置方法
- 右键“此电脑”
- 点击“属性”
- 进入“高级系统设置”
- 打开“环境变量”
- 在“系统变量”里找到
Path - 点击“编辑”
- 点击“新建”
- 把 MongoDB 的
bin路径加进去 - 一路确定保存
配完后怎么验证
打开命令提示符,输入:
mongod --version
如果能显示版本号,说明环境变量生效了。
六、启动 MongoDB
如果你安装时勾选了“作为服务运行”,可以直接让服务启动。
方法一:通过服务启动
- 按
Win + R - 输入:
services.msc
- 找到 MongoDB 服务
- 右键“启动”
如果服务已经在运行,就说明数据库已经起来了。
方法二:命令行手动启动
如果你没有装成服务,也可以手动启动。
先打开命令提示符,输入:
mongod --dbpath C:\data\db
如果你的数据目录在别的地方,就把路径改成你的实际路径。
例如:
mongod --dbpath D:\mongodb\data\db
启动成功后,窗口会持续输出日志,这说明数据库正在运行。
七、连接数据库
MongoDB 4.4 以后,通常推荐使用 mongosh 连接。
连接本机数据库
打开新的命令行窗口,输入:
mongosh
如果默认配置正常,它会自动连接本机 MongoDB。
如果你想指定连接地址,可以输入:
mongosh "mongodb://127.0.0.1:27017"
这里的 27017 是 MongoDB 默认端口。
八、测试是否安装成功
连接后,你可以做一个最简单的测试。
1. 查看当前数据库
show dbs
2. 切换到测试库
use testdb
3. 插入一条数据
db.user.insertOne({name: "Tom", age: 20})
4. 查询数据
db.user.find()
如果能正常看到返回结果,说明 MongoDB 已经可以正常使用了。
九、用 Compass 图形化查看
如果你装了 MongoDB Compass,打开后连接地址填:
mongodb://127.0.0.1:27017
点击连接后,你就能看到:
- 数据库列表
- 集合
- 文档内容
- 索引信息
对新手来说,Compass 很实用,能明显降低学习门槛。
常见问题排查
1. 输入 mongod 提示不是内部或外部命令
通常是环境变量没配好。
解决办法
- 检查 MongoDB 的
bin目录是否加入Path - 重新打开命令行窗口
- 用
mongod --version验证
2. 启动时报 Data directory ... not found
说明数据库目录不存在。
解决办法
手动创建:
C:\data\db
或者你启动时指定正确路径:
mongod --dbpath D:\mongodb\data\db
3. 端口 27017 被占用
说明这个端口已经被别的软件占了,或者之前的 MongoDB 进程没关干净。
解决办法
先查占用:
netstat -ano | findstr 27017
然后根据 PID 找进程并结束,或者换端口启动:
mongod --dbpath C:\data\db --port 27018
连接时也要改成对应端口:
mongosh "mongodb://127.0.0.1:27018"
4. 服务启动失败
可能原因有:
- 数据目录不存在
- 权限不足
- 安装路径异常
- 配置文件写错
解决办法
先看 MongoDB 日志,通常在数据目录或安装目录里能找到日志文件。
如果你是按默认方式装的,优先检查:
C:\data\db是否存在- 安装是否完整
- 是否有杀毒软件拦截
5. Compass 连不上
解决办法
先确认数据库本身正常运行,再检查连接地址:
mongodb://127.0.0.1:27017
如果你改过端口,就按实际端口填写。
注意事项
1. 不要随便删数据目录
MongoDB 的数据都保存在数据目录里。误删后,库和表可能直接没了。
2. 不要混淆服务启动和手动启动
如果你已经把 MongoDB 安装成服务,通常不需要再手动执行 mongod。
重复启动容易引发端口冲突。
3. 新手优先用稳定版
不要为了“最新”去装测试版。数据库环境最重要的是稳定。
4. 务必记住端口和路径
最常见的两个关键信息就是:
数据目录:C:\data\db
默认端口:27017
这两个地方出错,后面排查会很费时间。
5. 需要长期使用就装成服务
如果你是开发环境、学习环境,装成 Windows 服务最省心。
开机自动启动,省去每次手动敲命令。
总结
Windows 上安装 MongoDB,正确顺序就是:
- 下载官方稳定版安装包
- 安装 Community Server,建议顺带装 Compass 和 mongosh
- 创建数据目录
C:\data\db - 配好环境变量
- 启动服务或手动运行
mongod - 用
mongosh或 Compass 连接测试
只要目录、端口、环境变量这三件事没出错,MongoDB 在 Windows 上一般都能顺利跑起来。
关键词布局
本文围绕的核心关键词是:
mongodb安装windows
相关延伸词包括:
- MongoDB Windows 安装教程
- Windows 安装 MongoDB 配置
- MongoDB 环境变量设置
- MongoDB Compass 连接方法
- MongoDB 启动失败解决办法

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