本文详细讲解在 Windows 系统上安装和配置 MongoDB 的完整步骤。从官网下载预编译二进制包开始,逐步演示图形化安装向导、环境变量配置、数据目录创建,以及如何通过命令行启动服务或注册为系统服务。文末包含 MongoDB Shell 的基本使用示例,帮助开发者快速完成环境搭建。
安装效果预览
成功安装并启动 MongoDB 后,你将能够通过命令行工具(如 mongod)启动数据库服务,并通过 mongo 命令(或新版 mongosh)连接到数据库进行数据操作。服务配置完成后,MongoDB 将作为 Windows 后台服务运行,无需手动开启命令行窗口。

安装前准备说明
在开始安装之前,请确保满足以下条件:
- 系统要求:MongoDB 官方预编译包仅支持 64 位版本的 Windows 系统(如 Windows Server 2008 R2 及以上、Windows 7 及以上)。注意:MongoDB 2.2 版本后已不再支持 Windows XP,且最新版本已移除 32 位系统支持。
- 管理员权限:部分配置步骤(如注册系统服务)需要以管理员身份运行命令行工具。
- 网络环境:需能访问 MongoDB 官网下载页面。
操作正文
第1步:下载 MongoDB 预编译包
访问 MongoDB 官方社区版下载页面,获取适用于 Windows 64 位的预编译二进制包。
下载地址:https://www.mongodb.com/try/download/community
在下载页面中,请选择 MongoDB for Windows 64-bit 版本。该版本适用于 64 位的 Windows Server 2008 R2、Windows 7 及更新版本的 Windows 系统。

下载完成后,你会得到一个 .msi 安装文件。双击该文件以启动安装向导。
第2步:执行图形化安装向导
启动安装程序后,按照以下步骤完成安装:
- 启动安装:点击
Next按钮开始安装过程。

- 接受许可协议:阅读许可协议,选中
I accept the terms...选项,然后点击Next。

- 选择安装类型:系统提供两种运行身份选项:
Run as Network Service user(网络服务用户):适合简单测试和基本功能,权限管理较简单。Run as Local or Domain User account(本地或域用户账户):适合需要精细权限控制或使用特定凭据访问资源的场景。
对于大多数开发测试环境,选择第一个选项即可。点击
Next。

- 选择组件:推荐选择
Complete(完整安装),这将默认安装所有 MongoDB 组件和工具。你也可以根据需求选择Custom(自定义安装)。


- 完成安装:点击
Install开始安装。安装完成后,点击Finish关闭安装程序。


第3步:配置环境变量
为了让系统能够识别 mongod 和 mongo 命令,需要将 MongoDB 的 bin 目录添加到系统环境变量中。
- 右键点击
此电脑(或我的电脑),选择属性。 - 点击
高级系统设置。 - 在
系统属性窗口中,切换到高级选项卡,点击环境变量。 - 在
系统变量区域,找到Path变量,选中后点击编辑。 - 点击
新建,输入 MongoDB 的bin目录路径(例如:C:\Program Files\MongoDB\Server\X.X\bin,具体路径取决于你的安装位置)。 - 依次点击
确定保存设置。

第4步:创建数据目录
MongoDB 默认将数据存储在一个名为 db 的目录下。虽然安装程序有时会创建默认目录,但建议手动创建以确保路径清晰。
请在根目录(如 C: 或 D:)下创建以下目录结构:
cd C:
mkdir data
mkdir data\db
你也可以通过 Windows 资源管理器直接创建这些文件夹。确保路径中没有特殊字符或空格。
第5步:启动 MongoDB 服务
安装完成后,你有两种方式启动 MongoDB:临时命令行启动或注册为系统服务。推荐初学者使用命令行方式验证,生产环境建议使用系统服务方式。
方式一:命令行启动(适合测试)
打开命令提示符(CMD)或 PowerShell,执行以下命令启动 MongoDB 服务器,并指定数据目录:
mongod --dbpath c:\data\db
如果启动成功,命令行会输出类似以下的信息,显示 MongoDB 正在监听端口(默认 27017):

注意:此方式下,关闭命令行窗口将导致 MongoDB 服务停止。
方式二:配置并注册为系统服务(推荐)
此方式允许 MongoDB 在后台自动运行,无需手动开启命令行。
- 创建配置文件:
在 MongoDB 安装目录(例如
C:\mongodb)下创建一个名为mongod.cfg的配置文件。内容如下:systemLog: destination: file path: c:\data\log\mongod.log storage: dbPath: c:\data\db确保
c:\data\log目录已存在。 - 安装服务:
以管理员身份打开命令行,执行以下命令注册 MongoDB 服务:
mongod --config "C:\mongodb\mongod.cfg" --install - 启动服务:
执行以下命令启动 MongoDB 服务:
net start MongoDB - 管理服务:
- 停止服务:
net stop MongoDB - 移除服务:
mongod --remove
- 停止服务:
第6步:连接 MongoDB 并验证
MongoDB 6.0 版本后,默认不再安装 mongo shell 工具。你需要单独安装 MongoDB Shell (mongosh)。
安装完成后,在命令行中输入 mongo(或 mongosh)即可连接到本地运行的 MongoDB 实例:
mongo
连接成功后,你将进入 MongoDB 的交互式 Shell 环境,默认连接到 test 数据库。
问题与调整
- 问题:启动时提示“找不到 mongod”
- 原因:环境变量未正确配置,或命令行未重启。
- 解决:检查环境变量中
bin目录路径是否正确,并重新打开一个新的命令行窗口。
- 问题:启动时提示“数据目录权限不足”或“无法创建锁文件”
- 原因:数据目录权限设置不当,或已有进程占用端口。
- 解决:确保运行 MongoDB 的用户对数据目录有读写权限。如果端口被占用,检查是否有其他 MongoDB 实例在运行。
- 问题:32 位系统无法安装
- 原因:新版 MongoDB 已移除 32 位支持。
- 解决:请升级至 64 位 Windows 系统,或寻找非常旧的 MongoDB 版本(不推荐)。
总结
本文介绍了在 Windows 平台上安装和配置 MongoDB 的完整流程。关键点包括:下载 64 位预编译包、通过图形向导完成安装、配置环境变量以便全局调用命令、创建数据目录,以及选择命令行启动或系统服务模式。对于 MongoDB 6.0 及以上版本,请注意单独安装 mongosh 以使用 Shell 工具。完成上述步骤后,你将拥有一个可用的 MongoDB 开发环境。
以上就是 Windows 平台安装 MongoDB 的详细内容,更多关于 MongoDB 配置与使用的资料请关注本站其它相关文章!

