Windows系统安装MongoDB完整教程：从零开始轻松上手
一、为什么选择MongoDB？
MongoDB是目前最流行的NoSQL数据库之一，它以灵活的文档存储模型著称。与传统的关系型数据库不同，MongoDB不需要预先定义表结构，数据以JSON风格的文档形式存储，这使得它在处理频繁变化的数据结构、海量日志、物联网设备数据等场景下表现出色。对于后端开发者和全栈开发者来说，掌握MongoDB几乎是必备技能。
在Windows系统上安装MongoDB并不复杂，但很多初学者因为不了解细节而踩坑。比如版本选择不对、服务无法启动、环境变量配置错误等。本文将从零开始，一步步带你完成安装和配置，并解释每一步背后的原因，让你不仅会装，还懂得为什么这么做。
二、安装前的准备工作
在动手下载安装包之前，有几件事需要先确认清楚，否则可能白忙一场。
2.1 检查系统版本与硬件要求
MongoDB官方支持Windows 7及以上版本，包括Windows 10、Windows 11以及Windows Server系列。如果你的系统是Windows 7，需要确保已经安装了Service Pack 1。另外，MongoDB需要至少500MB的磁盘空间用于安装程序本身，但实际运行后数据会逐渐增长，建议预留至少几个GB的空间。
还有一个容易被忽视的点：MongoDB 6.0之后的版本不再支持Windows 7/8/8.1，只支持Windows 10/11和Windows Server 2016以上。所以如果你还在用老系统，建议先升级系统，或者选择MongoDB 5.0等旧版本。
2.2 下载正确的安装包
打开浏览器，访问MongoDB官方下载页面（https://www.mongodb.com/try/download/community）。你会看到几个选项：
- Version：选择最新的稳定版本，比如7.0或6.0。不建议选择RC（候选发布版），可能存在不稳定因素。
- Platform：选择Windows。
- Package：选择MSI（安装程序）格式，这是Windows下最方便的安装方式。
- Architecture：根据你的系统位数选择。现在绝大多数电脑都是64位，选择x64即可。如果是32位系统，只能安装较老的版本，但官方已经不推荐32位部署。
点击Download下载msi文件。注意，下载可能需要注册账号，但你可以直接点击“Skip”跳过注册，不影响下载。
三、详细安装步骤
3.1 运行安装程序
双击下载好的msi文件，会弹出用户账户控制提示，点击“是”允许运行。接着进入MongoDB安装向导界面，点击“Next”开始。
3.2 接受许可协议
勾选“I accept the terms in the License Agreement”，然后点击“Next”。这一步没什么好说的，所有软件安装都一样。
3.3 选择安装类型
这里有两个选项：Complete（完整安装）和Custom（自定义安装）。
- Complete：安装所有组件，包括MongoDB服务器、客户端工具（mongosh）、配置文件等。推荐新手选择此项，省心省力。
- Custom：可以手动选择安装路径和要安装的组件。如果你想把MongoDB安装到D盘或其他非系统盘，或者只想安装服务器而不安装图形化工具，可以选择Custom。
假设你选择了Custom，点击“Browse”选择一个安装目录，比如D:\MongoDB。记住这个路径，后面配置环境变量和数据目录时会用到。建议不要安装在C盘，以免占用系统盘空间。
3.4 配置MongoDB服务
在安装过程中，会出现一个“Service Configuration”页面，这是最关键的一步。
勾选“Install MongoDB as a Service”，这样MongoDB会被注册为Windows系统服务，开机自动启动，无需每次手动运行。下方还有几个选项：
- Service Name：默认是“MongoDB”，可以不改。
- Data Directory：数据存储路径，默认是
C:\Program Files\MongoDB\Server\7.0\data\。建议改成其他盘，比如D:\MongoDB\data。注意，这个目录需要手动创建，安装程序不会自动建。 - Log Directory：日志存储路径，同理可以改成
D:\MongoDB\log。
另外，下方还有一个“Run service as Network Service user”的选项，保持默认即可。如果你需要指定特定用户运行，可以取消勾选并输入用户名密码，但一般情况下不需要。
点击“Next”继续。
3.5 完成安装
安装程序会开始复制文件。等待进度条走完，点击“Finish”退出向导。如果勾选了“Install MongoDB Compass”（MongoDB的图形化管理工具），会另外弹出一个Compass的安装窗口，可以根据需要选择是否安装。Compass对于可视化操作很有帮助，但并非必需。
四、配置环境变量
安装完成后，为了方便在命令行中直接使用mongod、mongosh等命令，需要将MongoDB的bin目录添加到系统环境变量Path中。
4.1 打开环境变量设置
右键点击桌面上的“此电脑”或“计算机”，选择“属性”。在打开的窗口中点击左侧的“高级系统设置”，然后点击下方的“环境变量”按钮。
4.2 编辑Path变量
在“系统变量”列表中找到“Path”，选中后点击“编辑”。在弹出的编辑窗口中，点击“新建”，然后输入MongoDB的bin目录路径。默认安装路径是C:\Program Files\MongoDB\Server\7.0\bin（注意版本号可能不同）。如果你自定义了安装路径，比如D:\MongoDB\bin，就填那个。
点击“确定”保存所有打开的窗口。注意，修改环境变量后，需要重新打开命令提示符才能生效，已经打开的命令提示符不会自动更新。
4.3 验证环境变量
按下Win+R，输入cmd打开命令提示符。输入以下命令：
mongod --version
如果输出版本信息（例如db version v7.0.0），说明环境变量配置成功。如果提示“mongod 不是内部或外部命令”，说明路径填错了或者没有保存，请重新检查。
五、验证安装并启动MongoDB
5.1 启动MongoDB服务
由于我们在安装时已经勾选了“Install MongoDB as a Service”，服务应该已经自动启动了。但为了保险，可以手动确认一下。在命令提示符中输入：
net start MongoDB
如果服务已经启动，会提示“MongoDB 服务已经启动成功”。如果服务未启动，这条命令会启动它。如果提示“服务名无效”，说明服务没有正确注册，可能需要重新安装或手动注册服务（这种情况较少见）。
5.2 连接到MongoDB
新版的MongoDB已经用mongosh替代了旧的mongo命令。在命令提示符中输入：
mongosh
如果一切正常，你会进入MongoDB的交互式Shell，显示类似下面的信息：
Current Mongosh Log ID: 65a1b2c3d4e5f67890123456 Connecting to: mongodb://127.0.0.1:27017/?directConnection=true&serverSelectionTimeoutMS=2000&appName=mongosh+2.1.0 Using MongoDB: 7.0.0 Using Mongosh: 2.1.0 For mongosh info see: https://docs.mongodb.com/mongodb-shell/
这表示你已经成功连接到本地运行的MongoDB实例。可以输入show dbs查看已有数据库，输入exit退出Shell。
5.3 测试基本操作
为了确认数据库能正常读写，可以做一个简单测试。在mongosh中依次输入：
use testdb
db.users.insertOne({name: "张三", age: 25})
db.users.find()如果能看到插入的数据，说明MongoDB完全可用。
六、常见问题与解决方法
6.1 服务启动失败
如果在net start MongoDB时提示“服务无法启动”或“发生系统错误”，常见原因有：
- 端口被占用：MongoDB默认使用27017端口。在命令提示符中输入
netstat -ano | findstr 27017，如果有输出，说明有其他程序占用了该端口。可以用taskkill /PID <进程ID> /F结束占用进程，或者修改MongoDB的端口配置。 - 数据目录不存在：如果安装时指定的数据目录没有手动创建，MongoDB会报错。可以手动创建该目录，比如
mkdir D:\MongoDB\data，然后重新启动服务。 - 权限不足：如果服务以Network Service账户运行，但数据目录没有赋予相应权限，也会失败。可以右键数据目录→属性→安全→编辑，添加“NETWORK SERVICE”用户的完全控制权限。
6.2 命令行找不到mongod或mongosh
这一定是环境变量配置问题。重新检查Path中是否添加了正确的bin目录，注意路径中不要有多余的空格或分号。修改后务必关闭所有命令提示符窗口再重新打开。
6.3 连接时提示“connect ECONNREFUSED”
这意味着MongoDB服务没有运行。先检查服务状态：net start MongoDB。如果服务已启动但仍无法连接，可能是绑定的IP地址问题。默认情况下MongoDB只监听127.0.0.1，如果修改了配置文件绑定了其他IP，需要确保防火墙允许。
6.4 如何更改数据存储路径
如果你安装时没有指定自定义数据目录，后来想迁移，可以按以下步骤操作：
- 停止MongoDB服务：
net stop MongoDB - 将原来的数据目录（默认在
C:\Program Files\MongoDB\Server\7.0\data）复制到新位置，比如D:\MongoDBData - 编辑MongoDB的配置文件（默认在
C:\Program Files\MongoDB\Server\7.0\bin\mongod.cfg），找到dbPath一项，修改为新的路径 - 保存文件，重新启动服务：
net start MongoDB
注意，修改配置文件后，原来路径下的数据不会自动迁移，需要手动复制。
七、总结
通过以上步骤，你应该已经在Windows系统上成功安装并运行了MongoDB。整个过程可以分为三大块：下载安装包、安装并配置服务、设置环境变量。每一步都有其必要性，比如配置环境变量是为了方便命令行操作，注册为服务是为了让数据库随系统自动启动。
MongoDB的安装只是第一步，后续你还需要学习如何使用CRUD操作、索引、聚合管道等。但有了一个稳定的运行环境，剩下的就是实践了。如果在安装过程中遇到任何问题，可以参考官方文档或社区论坛，大部分问题都有现成的解决方案。
现在，打开你的命令提示符，输入mongosh，开始探索MongoDB的世界吧！