# @casual-simulation/monaco-editor 中文文档 规范地址：https://npmcn.com/package/%40casual-simulation/monaco-editor/ 版本：0\.47\.1 npm 元数据更新时间：2024-03-18T20:52:52.279Z 中文译文更新时间：2026-11-09T05:13:19.652Z 软件包许可：MIT 本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。 原始 npm 页面：https://www.npmjs.com/package/%40casual-simulation/monaco-editor 原文对照：https://npmcn.com/package/%40casual-simulation/monaco-editor/?lang=original 项目主页：https://github.com/casual-simulation/monaco-editor 源码仓库：https://github.com/casual-simulation/monaco-editor ## 关键信息（来自 npm 元数据） - 包体积（解压后）：92.3 MB，1420 个文件 - 模块格式：ES Module - TypeScript 类型：包内自带 - 运行依赖：3 个 - 首次发布：2022-11-17T21:53:07.910Z - 最新版本发布：2024-03-18T20:52:51.791Z - 近 30 天下载量：8872（2026-10-09 至 2026-11-07，npm 官方下载统计） - 已发布版本数：7（近 12 个月 0 个） ## 中文简介 基于浏览器的代码编辑器 ## 安装 ```sh npm install @casual-simulation/monaco-editor ``` 也可以使用：`pnpm add @casual-simulation/monaco-editor`、`yarn add @casual-simulation/monaco-editor`、`bun add @casual-simulation/monaco-editor` ## README # 摩纳哥编辑器 [![Versions](https://img.shields.io/npm/v/monaco-editor)](https://www.npmjs.com/package/monaco-editor) [![Versions](https://img.shields.io/npm/v/monaco-editor/next)](https://www.npmjs.com/package/monaco-editor) [![Feature Requests](https://img.shields.io/github/issues/microsoft/monaco-editor/feature-request.svg)](https://github.com/microsoft/monaco-editor/issues?q=is%3Aopen+is%3Aissue+label%3Afeature-request+sort%3Areactions-%2B1-desc) [![Bugs](https://img.shields.io/github/issues/microsoft/monaco-editor/bug.svg)](https://github.com/microsoft/monaco-editor/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aopen+label%3Abug) "摩纳哥编辑"是全功能的代码编辑,来自 [VS 代码](https://github.com/microsoft/vscode)检查 [VS 代码文件](https://code.visualstudio.com/docs/editor/editingevolved) 以查看一些支持的特性. ![image](https://user-images.githubusercontent.com/5047891/94183711-290c0780-fea3-11ea-90e3-c88ff9d21bd6.png) ## 试试看 试出编辑器,看看各种例子 [我们互动游乐场](https://microsoft.github.io/monaco-editor/playground.html)。 。 。 . 游乐场是学习如何使用编辑器的最佳方法,该编辑器的特性是支持的,可以尝试不同的版本,并为错误报告创建最小的可复制的例子. ## 安装 ``` > npm install monaco-editor ``` 你会得到: - 内部 `/esm`:编辑器的无害环境管理版本(与网页包等兼容) - 内部 `/dev`: AMD 捆绑了, 没有修改 - 内部 `/min`: AMD 捆绑并修改 - 内部 `/min-maps`: 用于 `min` - `monaco.d.ts`:这里指定了编辑器的API(这是实际版本的,其他的一切都被认为是私有的,可能会与任何发行相突破). 建议针对 `dev` 版本,并在生产中使用 `min` 版本. ## 概念 摩纳哥编辑最有名的是担任授权VS代码的文本编辑. 然而,它更细微一些. 为了有效地使用摩纳哥编辑,需要对基本概念有一些基本的理解. ### 模型 模特儿是摩纳哥编辑的核心. 这是你管理内容时的互动。 一个模型代表一个已经打开的文件. 这可以代表一个文件系统中存在的文件,但不必如此. 例如,模型持有文本内容,决定内容的语言,并跟踪内容的编辑历史. ### URIs 参考文献 每个型号由URI识别出. 这就是为什么两个模型不可能有相同的URI. 理想的情况是,当您在摩纳哥编辑器中代表内容时,您应该想到一个虚拟文件系统来匹配您的用户正在编辑的文件. 例如,你可以使用 `file:///` 作为基础路径。 如果一个模型是在没有URI的情况下创建的,那么它的URI将是: `inmemory://model/1`。随着更多模型的创建,数字会增加. ### 编辑器 一个编辑器是一个面对模型视图的用户. 这就是DOM的附着物, 和您的用户看到的视觉。 典型的编辑器操作是显示一个模型,管理视图状态,或者执行动作或命令. ### 供应商 提供商提供智能编辑功能. 例如,这包括完成和徘徊信息。 和这不一样 但经常是地图 [语言服务器协议](https://microsoft.github.io/language-server-protocol) 特性. 供应商致力于模型。 一些智能特性取决于文件URI. 例如,TypeScript用来解析导入,或JSON IntelliSense用来确定JSON的哪个方案适用于哪个模型. 因此选择合适的型号URI很重要. ### 可处置 许多与摩纳哥有关的物体经常执行 `.dispose()` 方法。 这种方法的目的是在不再需要资源时进行清理。 例如,电话 `model.dispose()` 将解除注册,释放URI 一个新的模型。 编辑人员应当处置释放出资源,取出其模式听众. ## 文档 - 学习如何将编辑器与这些集成 [完整样本](https://npmcn.com/package/%40casual-simulation/monaco-editor/samples/)。 。 。 . - [整合AMD版本](https://npmcn.com/package/%40casual-simulation/monaco-editor/docs/integrate-amd.md)。 。 。 . - [纳入无害环境管理版本](https://npmcn.com/package/%40casual-simulation/monaco-editor/docs/integrate-esm.md) - 学习如何使用编辑器 API 并尝试您自己的定制 [游乐场](https://microsoft.github.io/monaco-editor/playground.html)。 。 。 . - 探索 [API 文件](https://microsoft.github.io/monaco-editor/docs.html) 或直接读取 [`monaco.d.ts`](https://github.com/microsoft/monaco-editor/blob/gh-pages/node_modules/monaco-editor/monaco.d.ts)。 。 。 . - 读取 [本指南](https://github.com/microsoft/monaco-editor/wiki/Accessibility-Guide-for-Integrators) 以确保编辑器可供所有用户使用! - 为新编程语言创建君主代号 [在君主操场](https://microsoft.github.io/monaco-editor/monarch.html)。 。 。 . - 询问 [叠叠流](https://stackoverflow.com/questions/tagged/monaco-editor)搜索公开和关闭的问题, 里面有很多小费! ## 问题 创建 [问题](https://github.com/microsoft/monaco-editor/issues) 与《摩纳哥编辑》有关的任何信息都在本存储库中。 请搜索现有问题以避免重复. ## 财务问题 ❓ **VS代码与"摩纳哥编辑"有何关系??** 摩纳哥编辑器是由VS代码的源头直接生成的,一些shims环绕服务,代码需要使其运行在自己家外的网页浏览器中. ❓ **VS代码版本与"摩纳哥编辑"版本有何关系??** 无。 "摩纳哥编辑"是一个图书馆,直接反映源代码. ❓ **我为VS代码写了一个扩展, 它能在浏览器中工作吗?** 没有. > 注:如果扩展完全基于 [LSP 软件](https://microsoft.github.io/language-server-protocol/) 而如果语言服务器是用 JavaScript 编写的,那么就有可能了. ❓ **为什么所有这些网络工人 我为什么要在乎呢?** 语言服务创建网络工人来计算UI线外的重物. 只要能让他们工作(见上文跨域案例). ❓ **这是什么 `loader.js`我能用吗 `require.js`? 吗?** 它是一个AMD装载器,我们在VS代码中使用。 对. ❓ **我看到了警告 "不能创造网络工人" 我该怎么办?** HTML5 不允许装入页面 `file://` 创建网络工人。 请将编辑器装入网络服务器 `http://` 或者说 `https://` 计划. ❓ **在移动浏览器或移动网络应用框架中支持编辑器吗?** 没有. ❓ **为什么编辑不支持TextMate语法?** - 请看 [https://github.com/bolinfest/monaco-tm 互联网档案馆的存檔,存档日期2014-12-21](https://github.com/bolinfest/monaco-tm) 集合起来 `monaco-editor`, (中文(简体) ), `vscode-oniguruma` 财务报告和审定财务报表 `vscode-textmate` 在编辑器中获取 TM 语法支持. ## 捐款/地方发展 我们欢迎社区的贡献! 请看 [捐款](https://npmcn.com/package/%40casual-simulation/monaco-editor/CONTRIBUTING.md) 详细介绍您如何有效贡献,如何从源头运行编辑器,以及如何调试和修正问题. ## 行为守则 该项目通过了 [Microsoft 开源行为守则](https://opensource.microsoft.com/codeofconduct/)。更多信息见 [《行为守则》](https://opensource.microsoft.com/codeofconduct/faq/) 或联系人 [打开码@ microsoft.com](mailto:opencode@microsoft.com) 并附上任何其他问题或评论. ## 许可证 凭 [麻省理工学院](https://github.com/microsoft/monaco-editor/blob/main/LICENSE.txt) 执照. ## 常见问题 ### @casual-simulation/monaco-editor 是什么？ 基于浏览器的代码编辑器 ### 如何安装 @casual-simulation/monaco-editor？ 在项目目录运行 npm install @casual-simulation/monaco-editor，或使用 pnpm add / yarn add / bun add。 ### @casual-simulation/monaco-editor 支持 TypeScript 吗？ 支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。 ### @casual-simulation/monaco-editor 支持 ESM 还是 CommonJS？ 以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。 ### @casual-simulation/monaco-editor 可以商用吗？ @casual-simulation/monaco-editor 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。 ### @casual-simulation/monaco-editor 的下载量有多少？ 根据 npm 官方下载统计，@casual-simulation/monaco-editor 在 2026/10/09 – 2026/11/07 这 30 天内被下载 8,872 次，日均约 296 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。 ### @casual-simulation/monaco-editor 还在维护吗？ 最新版本 0\.47\.1 发布于 2024/03/19（2 年前）；至今共发布 7 个版本，其中过去 12 个月发布了 0 个；首次发布于 2022/11/18。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。