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

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是什么:核心特性、架构与应用场景解析
数据库 · 2026-09-01

Redis是什么:核心特性、架构与应用场景解析

Redis是一款基于内存的键值型NoSQL数据库,以超高读写速度和丰富的数据结构著称。本文系统梳理Redis的核心特性、架构组成、性能优势及典型应用场景,并通过与Memcached、MySQL、MongoDB的对比,帮助开发者快速判断Redis是否适合当前业务需求。

Windows 安装 MongoDB 完整图文教程
数据库 · 2026-09-01

Windows 安装 MongoDB 完整图文教程

本文详细介绍在 Windows 系统上安装 MongoDB 的完整流程。从官网下载 MSI 安装包开始,逐步演示自定义安装路径、配置 Windows 服务、跳过 MongoDB Compass 等关键选项,并提供通过系统服务列表验证安装是否成功的方法,帮助开发者快速搭建本地 MongoDB 环境。

Linux 安装 MongoDB 完整指南:依赖配置、环境变量与服务启动
数据库 · 2026-09-01

Linux 安装 MongoDB 完整指南:依赖配置、环境变量与服务启动

本文详解在 Linux 系统下安装 MongoDB 的完整流程,涵盖依赖包安装、二进制包下载解压、环境变量配置、数据与日志目录创建及服务启动验证。通过标准化命令与路径说明,帮助开发者快速完成部署并确认服务状态。

MacOS安装MongoDB完整教程
数据库 · 2026-09-01

MacOS安装MongoDB完整教程

本文介绍在MacOS系统下安装MongoDB的完整流程,涵盖下载、解压、目录配置、环境变量设置及服务启动。通过明确的命令与参数说明,帮助开发者快速完成环境搭建并验证安装结果。

Ubuntu系统安装与配置Redis完整指南
数据库 · 2026-09-01

Ubuntu系统安装与配置Redis完整指南

本文详解在Ubuntu系统中安装Redis的两种主流方式:apt在线安装与源码编译安装。涵盖版本选择逻辑、服务启停与状态检查、连接验证方法,以及在线练习工具与桌面GUI客户端的对比与使用建议,帮助开发者快速搭建并验证Redis运行环境。