游乐游手机版
首页/数据库/文章详情

MongoDB Shell(mongosh)安装与使用教程:macOS/Linux/Windows全平台指南

时间:2026-08-31 11:08
MongoDB Shell(mongosh)是基于JavaScript的官方交互式数据库管理工具。本文详细讲解如何在macOS、Linux和Windows系统上安装mongosh,并提供从启动连接、执行CRUD操作到退出Shell的完整命令行示例,帮助用户快速掌握数据库管理技能。

MongoDB Shell(mongosh)是基于JavaScript的官方交互式数据库管理工具。本文详细讲解如何在macOS、Linux和Windows系统上安装mongosh,并提供从启动连接、执行CRUD操作到退出Shell的完整命令行示例,帮助用户快速掌握数据库管理技能。

MongoDB Shell 核心功能预览

MongoDB Shell (简称 mongosh) 是 MongoDB 官方提供的交互式命令行界面。它基于 JavaScript 构建,允许开发者直接在终端中执行命令、查询数据和管理数据库实例。相比旧版工具,新版 Shell 提供了更现代的交互体验和更完善的调试功能。

MongoDB Shell命令行执行插入、查询和删除文档的完整过程截图
图1:MongoDB Shell 执行插入、查询和删除文档的完整过程截图

安装 MongoDB Shell

MongoDB Shell 通常随 MongoDB 数据库服务器一同分发。如果你已经安装了完整的 MongoDB 服务器,Shell 通常已包含在内。若需单独安装或仅使用 Shell,可参考以下各操作系统的安装指南。

第1步:在 macOS 上安装 MongoDB Shell

macOS 用户推荐使用 Homebrew 进行安装,这是最便捷的方式。若需手动安装,可从官网下载二进制文件。

使用 Homebrew 安装

如果你已配置 Homebrew,执行以下命令即可获取最新版 MongoDB Shell:

brew tap mongodb/brew
brew install mongodb-community-shell

安装完成后,终端将自动配置好环境变量。

手动下载安装

若不使用包管理器,可访问 MongoDB 官网下载页面(https://www.mongodb.com/try/download/shell)获取 macOS 安装包。

MongoDB官网下载页面中MongoDB Shell的下载选项截图
图2:MongoDB官网下载页面中MongoDB Shell的下载选项截图

下载完成后,解压文件并将 bin 目录下的 mongosh 二进制文件复制到系统路径(如 /usr/local/bin):

sudo cp mongosh /usr/local/bin/
sudo cp mongosh_crypt_v1.so /usr/local/lib/

注意:若 macOS 安全策略阻止运行,需前往“系统偏好设置” → “安全与隐私”中允许该应用运行。

第2步:在 Linux 上安装 MongoDB Shell

大多数 Linux 发行版支持通过包管理器安装。以下以 Ubuntu 22.04 (Jammy) 为例:

使用 APT 包管理器

首先配置官方软件源:

echo "deb [ arch=amd64,arm64 ] https://repo.mongodb.org/apt/ubuntu jammy/mongodb-org/7.0 multiverse" | sudo tee /etc/apt/sources.list.d/mongodb-org-7.0.list

更新源列表并安装 Shell:

sudo apt update
sudo apt install mongodb-shell

手动下载安装

同样可从官网下载 Linux 版本的 Shell 安装包。

MongoDB官网下载页面中Linux系统MongoDB Shell的下载选项截图
图3:MongoDB官网下载页面中Linux系统MongoDB Shell的下载选项截图

解压后,将 mongosh 复制到 /usr/local/bin 即可使用。

第3步:在 Windows 上安装 MongoDB Shell

访问 MongoDB 官网下载页面,选择适用于 Windows 的安装程序。

MongoDB官网下载页面中Windows系统MongoDB Shell的下载选项截图
图4:MongoDB官网下载页面中Windows系统MongoDB Shell的下载选项截图

运行安装程序,按照向导提示操作。默认情况下,安装程序会包含 MongoDB Shell。建议在安装过程中勾选“配置环境变量”,以便在任意命令行窗口直接调用 mongosh

使用 MongoDB Shell 进行数据库操作

安装完成后,即可通过命令行启动 Shell 并连接数据库。以下是完整的操作流程与示例。

第4步:启动并连接 MongoDB 服务器

在终端输入 mongosh 即可启动。若服务器运行在本地默认端口(27017),将自动连接。

mongosh

若需指定主机或端口,可使用以下格式:

mongosh --host :

连接成功后,命令行提示符将变为 test>,表示已就绪。

第5步:执行基本数据库操作

连接成功后,可执行以下常用命令:

  • 查看当前数据库:db
  • 显示所有数据库:show dbs
  • 切换数据库:use
  • 插入文档:db..insertOne({ ... })
  • 查询文档:db..find()
  • 更新文档:db..updateOne({ ... })
  • 删除文档:db..deleteOne({ ... })
  • 退出 Shell:quit()exit

第6步:完整操作实例演示

以下示例演示了从启动 Shell 到执行增删改查的全过程:

# 启动 MongoDB Shell
mongosh
# 连接到本地 MongoDB 服务器
test> show dbs
admin   40.00 KiB
config  72.00 KiB
local   40.00 KiB
runoob  72.00 KiB
test> use runoob
switched to db runoob
# 插入文档
runoob> db.mycollection.insertOne({ name: "Alice", age: 30 })
{
  acknowledged: true,
  insertedId: ObjectId('667cd8789a69705686ed70f2')
}
# 查询文档
runoob> db.mycollection.find()
[
  { _id: ObjectId('667cd8789a69705686ed70f2'), name: 'Alice', age: 30 }
]
# 更新文档
runoob> db.mycollection.updateOne({ name: "Alice" }, { $set: { age: 31 } })
{
  acknowledged: true,
  insertedId: null,
  matchedCount: 1,
  modifiedCount: 1,
  upsertedCount: 0
}
# 删除文档
runoob> db.mycollection.deleteOne({ name: "Alice" })
{ acknowledged: true, deletedCount: 1 }
# 退出 MongoDB Shell
runoob> quit()

通过上述步骤,你可以熟练运用 MongoDB Shell 进行日常数据库管理与维护。

常见问题与调整

  • macOS 安全拦截:若提示“无法打开,因为无法验证开发者”,请前往“系统偏好设置” → “安全与隐私” → “通用”中点击“仍要打开”。
  • 连接被拒绝:若启动 Shell 后提示连接失败,请确认 MongoDB 服务已启动且端口(默认 27017)未被防火墙拦截。
  • 版本不一致:确保 Shell 版本与服务器版本兼容,建议保持两者大版本一致。

总结

MongoDB Shell 是管理 MongoDB 数据库的高效工具。通过本文介绍的跨平台安装方法及标准 CRUD 操作示例,用户可以快速上手并执行复杂的数据库任务。建议在实际生产环境中,结合官方文档(https://www.mongodb.com/zh-cn/docs/mongodb-shell/install/)进行更深入的安全配置与性能调优。

以上就是 MongoDB Shell(mongosh)安装与使用教程的详细内容,更多关于 MongoDB 数据库管理的资料请关注本站其它相关文章!

来源:https://www.runoob.com/mongodb/mongodb-shell.html
上一篇MongoDB核心概念详解:从SQL到NoSQL的映射与基础架构 下一篇Mac OSX 平台安装 MongoDB 完整指南:手动与 Homebrew 双方案
本站内容用于信息整理与展示,如有侵权或内容问题请及时联系处理。

相关推荐

补充同频道和同主题内容,方便继续浏览更多相关内容。

同类最新

继续查看同栏目最近更新的文章。

更多
Redis Hash 哈希散列:底层原理、存储结构与常用命令详解
数据库 · 2026-08-31

Redis Hash 哈希散列:底层原理、存储结构与常用命令详解

本文详解 Redis Hash 哈希散列的底层存储结构(ziplist 与 dict)、哈希冲突解决机制及常用命令操作。通过图解与实战示例,帮助开发者掌握 Hash 类型在对象存储场景中的高效应用与内存优化策略。

Redis Set 集合详解:底层原理、常用命令与实战示例
数据库 · 2026-08-31

Redis Set 集合详解:底层原理、常用命令与实战示例

本文系统讲解 Redis Set 集合的核心特性与底层存储机制,涵盖 intset 与哈希表的切换条件、结构体定义及内存优化策略。通过完整命令汇总与终端交互示例,帮助开发者掌握集合操作、交集 并集 差集计算及实际应用场景。

Redis连接命令详解:AUTH、PING、SELECT等命令使用指南
数据库 · 2026-08-31

Redis连接命令详解:AUTH、PING、SELECT等命令使用指南

本文详细解析Redis连接命令,包括AUTH、PING、SELECT、ECHO和QUIT等核心命令的语法、参数、返回值及常见错误处理。通过实操示例演示如何建立连接、验证密码、切换数据库及安全断开连接,帮助开发者快速掌握Redis客户端与服务端的交互机制。

Redis PubSub发布订阅模式详解:命令、流程与使用场景
数据库 · 2026-08-31

Redis PubSub发布订阅模式详解:命令、流程与使用场景

Redis PubSub(发布 订阅)是一种基于频道的消息多播机制,适用于实时通知与轻量级解耦场景。本文通过图解与终端交互示例,演示订阅、发布与接收的完整流程,汇总常用命令并说明模式匹配与状态查询方法,帮助开发者快速掌握其使用边界与注意事项。

Redis Stream消息队列:核心概念、命令与实战指南
数据库 · 2026-08-31

Redis Stream消息队列:核心概念、命令与实战指南

Redis 5 0引入的Stream数据类型提供了具备持久化与主从复制能力的消息队列功能。本文系统梳理Stream的核心架构、消息ID生成规则、消费组机制及ACK确认流程,并通过完整的CLI命令示例演示消息的发布、消费与状态管理,帮助开发者快速掌握Redis Stream的实战用法。