MongoDB Windows 安装全攻略：从下载到验证，一篇讲透

一、先说结论：Windows 上怎么装 MongoDB 最省事

如果你是 Windows 用户，想在本机快速搭建 MongoDB 开发环境，最稳妥的方式就是：

下载 MongoDB Community 版
安装为 Windows 服务
配置数据目录和日志目录
把 MongoDB 的 bin 目录加入环境变量
用命令行验证是否安装成功

如果你只是想做开发测试，这套方法最省心；如果你还要长期使用，建议再把 MongoDB Shell（mongosh） 一起装好，后面管理数据库会更方便。

二、MongoDB 是什么，为什么很多人会用它

MongoDB 是一款比较常见的 文档型数据库，和传统的 MySQL、SQL Server 不太一样。它不按“表格”来存数据，而是按 文档（JSON 风格） 存数据，适合以下场景：

网站后台
用户资料存储
日志系统
内容管理
需要灵活字段结构的项目

它的特点是：

安装简单
扩展性强
开发时上手快
对 JSON 数据很友好

如果你是做前后端开发、Node.js 项目、Python 项目，MongoDB 很常见。

三、安装前要准备什么

开始安装之前，先确认你的电脑满足下面这些条件：

1. 系统要求

Windows 10 / Windows 11 较常见
64 位系统更适合
尽量不要用太老的系统版本

2. 权限要求

安装时最好使用 管理员身份运行，这样可以避免服务安装失败、目录权限不足等问题。

3. 硬盘空间

MongoDB 本身占用不大，但后续数据会越来越多，建议至少预留 2GB 以上 可用空间，开发环境更推荐留得宽松一点。

四、MongoDB Windows 安装步骤

下面按最常见的方式来讲，适合绝大多数新手。

第一步：下载 MongoDB 安装包

打开 MongoDB 官方下载页面，选择：

Platform：Windows
Package：msi
Version：稳定版即可
Edition：Community
Architecture：64-bit

下载后，你会得到一个 .msi 安装文件。

第二步：开始安装

双击安装包，进入安装向导。

安装过程中一般会出现几个选项：

1. 选择安装类型

通常会看到：

Complete（完整安装）
Custom（自定义安装）

如果你是新手，建议直接选 Complete，省心。

2. 配置服务

安装时一般会有一个选项：

Install MongoDB as a Service

建议勾选，这样 MongoDB 会作为 Windows 服务运行，开机后更方便自动启动。

你可能还会看到这些选项：

Run service as Network Service user
Install MongoDB Compass

建议：

服务账户：默认即可
MongoDB Compass：建议勾选，方便图形化管理数据库

MongoDB 需要两个关键目录：

数据目录（dbpath）：存放数据库文件
日志目录：记录运行日志

常见建议路径：

数据目录：D:\MongoDB\data
日志目录：D:\MongoDB\log

如果你不想放 D 盘，也可以放在 C 盘，但建议不要放在系统盘根目录，最好分层清楚，比如：

C:\MongoDB\data
C:\MongoDB\log

安装前最好手动创建这两个文件夹。

第三步：把 MongoDB 加入环境变量

安装完成后，最关键的一步就是把 bin 目录加到系统环境变量里。

MongoDB 默认安装路径常见类似：

C:\Program Files\MongoDB\Server\7.0\bin

操作方法：

右键 此电脑
选择属性
点击 高级系统设置
打开 环境变量
在“系统变量”里找到 Path
点击编辑
点击新建
把 MongoDB 的 bin 路径粘贴进去
一路确定保存

这样做完后，你就可以在任意命令行窗口里直接使用 mongod、mongosh 这些命令了。

五、手动配置 MongoDB 服务启动参数

有些情况下，安装程序没有自动帮你配置好，或者你想自己控制数据目录和日志目录，这时可以手动创建配置文件。

1. 创建配置文件

例如新建一个文件：

C:\MongoDB\mongod.cfg

内容可以写成这样：

systemLog:
  destination: file
  path: C:\MongoDB\log\mongod.log
storage:
  dbPath: C:\MongoDB\data
net:
  port: 27017
  bindIp: 127.0.0.1

参数说明：

systemLog.path：日志文件路径
storage.dbPath：数据库数据存放位置
net.port：端口号，MongoDB 默认是 27017
bindIp：绑定地址，127.0.0.1 代表只允许本机访问

2. 安装 MongoDB 服务

以管理员身份打开 命令提示符，输入：

mongod --config "C:\MongoDB\mongod.cfg" --install

然后启动服务：

net start MongoDB

如果要停止服务：

net stop MongoDB

六、验证 MongoDB 是否安装成功

安装完成后，先检查服务是否启动。

方法一：看服务列表

按 Win + R
输入 services.msc
找到 MongoDB
查看状态是否为“正在运行”

方法二：用命令行检查

打开命令提示符，输入：

mongod --version

如果能显示版本号，说明 MongoDB 可执行程序已生效。

如果你安装了 mongosh，再输入：

mongosh

如果成功进入交互界面，说明数据库服务正常。

七、第一次连接 MongoDB 的正确方法

MongoDB 安装成功后，很多人会卡在“怎么连上去”。

本机连接方式

打开命令行，输入：

mongosh

默认会连接：

mongodb://127.0.0.1:27017

如果一切正常，你会看到类似连接成功的提示。

指定连接地址

如果你想手动连接：

mongosh "mongodb://127.0.0.1:27017"

八、常见安装问题与解决方法

问题 1：`mongod` 不是内部或外部命令

原因：

没有配置环境变量。

解决方法：

检查 MongoDB 的 bin 目录是否加进了 Path，比如：

C:\Program Files\MongoDB\Server\7.0\bin

加完后重新打开命令行窗口，再试一次。

问题 2：MongoDB 服务启动失败

原因：

常见有三种：

数据目录不存在
日志目录不存在
配置文件路径写错

解决方法：

确认这些目录都已经手动创建：

C:\MongoDB\data
C:\MongoDB\log

并检查配置文件中的路径是否完全正确。

问题 3：端口 27017 被占用

原因：

别的软件占用了 MongoDB 默认端口。

解决方法：

先查端口占用：

netstat -ano | findstr 27017

如果确认被占用，可以：

关闭占用程序
或修改 MongoDB 配置文件中的端口，比如改成 27018

修改后：

net:
  port: 27018
  bindIp: 127.0.0.1

然后重启服务。

问题 4：无法连接数据库

原因：

服务没启动，或者 mongosh 没安装好。

解决方法：

先确认服务状态，再执行：

net start MongoDB

如果服务已经启动，再尝试：

mongosh

问题 5：安装了但找不到 Compass

原因：

安装时没勾选，或者单独没装。

解决方法：

MongoDB Compass 可以单独下载安装。它适合不想老敲命令的新手，查看集合、文档、索引都很直观。

九、推荐的新手安装方式

如果你是第一次接触 MongoDB，推荐你这样装：

下载 MongoDB Community MSI 安装包
选择 Complete
勾选 Install as a Service
勾选 MongoDB Compass
手动创建 data 和 log 文件夹
配好环境变量
用 mongosh 测试连接

这套流程最稳，不容易出幺蛾子。

十、进阶用户可以怎么做

如果你已经有一定基础，下面这些做法会更灵活：

1. 自定义安装目录

可以把 MongoDB 放在非系统盘，方便管理，比如：

D:\Apps\MongoDB\

适合软件装得比较多的用户。

2. 改默认端口

如果本机已经跑了多个数据库服务，可以把 MongoDB 端口改成别的，比如：

27018
28017

这样避免冲突。

3. 只开放本机访问

开发时建议保留：

bindIp: 127.0.0.1

这样更安全，不会把数据库暴露给局域网其他机器。

4. 配合防火墙使用

如果你确实需要局域网访问 MongoDB，记得在 Windows 防火墙里放行对应端口，并限制可信网段访问，别直接裸奔开放。

十一、卸载 MongoDB 的方法

如果你想删掉重装，按这个顺序来：

1. 停止服务

net stop MongoDB

2. 卸载服务

mongod --remove

或者根据你的安装配置使用对应命令。

3. 卸载程序

进入：

控制面板
应用和功能
找到 MongoDB
点击卸载

4. 删除残留文件

可手动删除：

安装目录
数据目录
日志目录
环境变量中的 MongoDB 路径

如果不清理残留，下次重装可能会遇到旧配置冲突。

十二、安装 MongoDB 后，建议顺手做的几件事

为了后面少踩坑，建议你装完后顺手检查这几项：

1. 确认服务自启动

服务模式下，建议设为自动启动，重启电脑后不用手动开。

2. 确认数据目录权限正常

如果目录放在某些受限位置，可能会出现写入失败。

3. 备份配置文件

以后如果改端口、改路径，保留一份备份，方便回滚。

4. 保留安装版本号

不同版本 MongoDB 在兼容性上有差异，做项目时最好记清楚版本。

十三、适合新手的最简安装总结

如果你只想快速装好，可以记住这几句话：

下载 MongoDB Community MSI
安装时选 Complete
勾选 作为服务安装
创建好 data 和 log 文件夹
配置好环境变量
用 mongosh 连接测试

照着做，基本就能成功。

十四、安装 MongoDB Windows 时最容易忽略的细节

最后补几个很容易忽略的小问题：

1. 路径不要带奇怪字符

尽量不要把 MongoDB 安装到带中文、空格过多、特殊符号的路径里，虽然很多时候也能用，但排错时更麻烦。

2. 命令行窗口要重新打开

改完环境变量后，旧的命令行窗口不会立刻生效，必须关掉重新开。

3. 数据目录别乱删

MongoDB 的数据文件删掉后，库里的数据就没了。重装前一定要先确认是否需要备份。

4. 安装版本尽量统一

如果团队开发，MongoDB 版本最好统一，不然不同版本之间有时会出现兼容问题。

十五、结尾总结

MongoDB 在 Windows 上安装并不复杂，关键就是 安装包选择正确、数据目录和日志目录配置好、环境变量设置对、服务能正常启动。
只要把这几个核心点处理好，后面无论是本地开发、接口联调，还是图形化管理数据库，都会顺很多。

如果你是电脑小白，按这篇文章一步一步做，基本可以独立完成 MongoDB Windows 安装，并顺利连上数据库。

mongodb windows安装

MongoDB Windows 安装全攻略：从下载到验证，一篇讲透

一、先说结论：Windows 上怎么装 MongoDB 最省事

二、MongoDB 是什么，为什么很多人会用它

三、安装前要准备什么

1. 系统要求

2. 权限要求

3. 硬盘空间

四、MongoDB Windows 安装步骤

第一步：下载 MongoDB 安装包

第二步：开始安装

1. 选择安装类型

2. 配置服务

3. 设置数据目录和日志目录

第三步：把 MongoDB 加入环境变量

操作方法：

五、手动配置 MongoDB 服务启动参数

1. 创建配置文件

参数说明：

2. 安装 MongoDB 服务

六、验证 MongoDB 是否安装成功

方法一：看服务列表

方法二：用命令行检查

七、第一次连接 MongoDB 的正确方法

本机连接方式

指定连接地址

八、常见安装问题与解决方法

问题 1：mongod 不是内部或外部命令

原因：

解决方法：

问题 2：MongoDB 服务启动失败

原因：

解决方法：

问题 3：端口 27017 被占用

原因：

解决方法：

问题 4：无法连接数据库

原因：

解决方法：

问题 5：安装了但找不到 Compass

原因：

解决方法：

九、推荐的新手安装方式

十、进阶用户可以怎么做

1. 自定义安装目录

2. 改默认端口

3. 只开放本机访问

4. 配合防火墙使用

十一、卸载 MongoDB 的方法

1. 停止服务

2. 卸载服务

3. 卸载程序

4. 删除残留文件

十二、安装 MongoDB 后，建议顺手做的几件事

1. 确认服务自启动

2. 确认数据目录权限正常

3. 备份配置文件

4. 保留安装版本号

十三、适合新手的最简安装总结

十四、安装 MongoDB Windows 时最容易忽略的细节

1. 路径不要带奇怪字符

2. 命令行窗口要重新打开

3. 数据目录别乱删

4. 安装版本尽量统一

十五、结尾总结

相关阅读

发表评论取消回复

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

问题 1：`mongod` 不是内部或外部命令