@casual-simulation/monaco-editor

中文文档
0.47.1发布于 2024/03/19MITTypeScriptES Module近 30 天下载 8872

基于浏览器的代码编辑器

中文使用文档
文档目录14 节
  1. 试试看
  2. 安装
  3. 概念
  4. 模型
  5. URIs 参考文献
  6. 编辑器
  7. 供应商
  8. 可处置
  9. 文档
  10. 问题
  11. 财务问题
  12. 捐款/地方发展
  13. 行为守则
  14. 许可证

摩纳哥编辑器

Versions Versions Feature Requests Bugs

"摩纳哥编辑"是全功能的代码编辑,来自 VS 代码检查 VS 代码文件 以查看一些支持的特性.

image

试试看

试出编辑器,看看各种例子 我们互动游乐场。 。 。 .

游乐场是学习如何使用编辑器的最佳方法,该编辑器的特性是支持的,可以尝试不同的版本,并为错误报告创建最小的可复制的例子.

安装

> 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的附着物, 和您的用户看到的视觉。 典型的编辑器操作是显示一个模型,管理视图状态,或者执行动作或命令.

供应商

提供商提供智能编辑功能. 例如,这包括完成和徘徊信息。 和这不一样 但经常是地图 语言服务器协议 特性.

供应商致力于模型。 一些智能特性取决于文件URI. 例如,TypeScript用来解析导入,或JSON IntelliSense用来确定JSON的哪个方案适用于哪个模型. 因此选择合适的型号URI很重要.

可处置

许多与摩纳哥有关的物体经常执行 .dispose() 方法。 这种方法的目的是在不再需要资源时进行清理。 例如,电话 model.dispose() 将解除注册,释放URI 一个新的模型。 编辑人员应当处置释放出资源,取出其模式听众.

文档

问题

创建 问题 与《摩纳哥编辑》有关的任何信息都在本存储库中。 请搜索现有问题以避免重复.

财务问题

❓ VS代码与"摩纳哥编辑"有何关系??

摩纳哥编辑器是由VS代码的源头直接生成的,一些shims环绕服务,代码需要使其运行在自己家外的网页浏览器中.

❓ VS代码版本与"摩纳哥编辑"版本有何关系??

无。 "摩纳哥编辑"是一个图书馆,直接反映源代码.

❓ 我为VS代码写了一个扩展, 它能在浏览器中工作吗?

没有.

注:如果扩展完全基于 LSP 软件 而如果语言服务器是用 JavaScript 编写的,那么就有可能了.

❓ 为什么所有这些网络工人 我为什么要在乎呢?

语言服务创建网络工人来计算UI线外的重物. 只要能让他们工作(见上文跨域案例).

❓ 这是什么 loader.js我能用吗 require.js? 吗?

它是一个AMD装载器,我们在VS代码中使用。 对.

❓ 我看到了警告 "不能创造网络工人" 我该怎么办?

HTML5 不允许装入页面 file:// 创建网络工人。 请将编辑器装入网络服务器 http:// 或者说 https:// 计划.

❓ 在移动浏览器或移动网络应用框架中支持编辑器吗?

没有.

❓ 为什么编辑不支持TextMate语法?

捐款/地方发展

我们欢迎社区的贡献! 请看 捐款 详细介绍您如何有效贡献,如何从源头运行编辑器,以及如何调试和修正问题.

行为守则

该项目通过了 Microsoft 开源行为守则。更多信息见 《行为守则》 或联系人 打开码@ microsoft.com 并附上任何其他问题或评论.

许可证

凭 麻省理工学院 执照.

版本与发布记录

@casual-simulation/monaco-editor 共发布 7 个版本,首次发布于 2022/11/18;过去 12 个月发布了 0 个版本。

版本发布日期距今
0.47.1latest2024/03/192 年前
0.35.4-alpha.12024/03/162 年前
0.35.4-alpha.02024/03/152 年前
0.35.32023/02/223 年前
0.35.22023/02/223 年前
0.34.32022/12/223 年前

关于 @casual-simulation/monaco-editor 的常见问题

@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 和提交记录判断。