# @codingame/monaco-editor-wrapper 中文文档

规范地址：https://npmcn.com/package/%40codingame/monaco-editor-wrapper/

版本：36\.0\.0
npm 元数据更新时间：2026-11-06T15:41:55.459Z
中文译文更新时间：2026-11-10T08:54:17.366Z
软件包许可：未声明

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40codingame/monaco-editor-wrapper
原文对照：https://npmcn.com/package/%40codingame/monaco-editor-wrapper/?lang=original
项目主页：https://github.com/CodinGame/monaco-editor-wrapper#readme
源码仓库：https://github.com/CodinGame/monaco-editor-wrapper

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：13 MB，486 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：86 个
- 首次发布：2021-11-09T16:55:46.727Z
- 最新版本发布：2026-11-06T15:41:55.045Z
- 近 30 天下载量：4923（2026-10-10 至 2026-11-08，npm 官方下载统计）
- 已发布版本数：197（近 12 个月 25 个）

## 中文简介

配置有工具和扩展名的 monaco- vscode- api

## 安装

```sh
npm install @codingame/monaco-editor-wrapper
```

也可以使用：`pnpm add @codingame/monaco-editor-wrapper`、`yarn add @codingame/monaco-editor-wrapper`、`bun add @codingame/monaco-editor-wrapper`

## README

# @codingame/monaco-editor-wrapper) – 互联网档案馆的存檔,存档日期2013-12-21 [![monthly downloads](https://img.shields.io/npm/dm/@codingame/monaco-editor-wrapper)](https://www.npmjs.com/package/@codingame/monaco-editor-wrapper) [![npm version](https://img.shields.io/npm/v/@codingame/monaco-editor-wrapper.svg?style=flat)](https://www.npmjs.com/package/@codingame/monaco-editor-wrapper) [![PRs welcome](https://img.shields.io/badge/PRs-welcome-brightgreen.svg)](https://github.com/codingame/monaco-editor-wrapper/pulls)

## 概要

摩纳哥编辑器包装器使用和配置 [monaco- vscode- api 密码](https://www.npmjs.com/package/@codingame/monaco-vscode-api) 给你的

包括一些工具

-   `preventAlwaysConsumeTouchEvent`,与 `alwaysConsumeMouseWheel` monaco 编辑器选项
-   `collapseCodeSectionsFromRanges` 允许创建并崩溃代码段
-   `collapseCodeSections` 允许在 2 个令牌之间创建并崩溃代码段
-   `registerTextDecorationProvider` 允许计算所有现有编辑器上的装饰
-   `hideCodeWithoutDecoration` 允许隐藏有特定装饰的代码部分
-   `lockCodeWithDecoration` 允许在特定装饰内制作只读代码部分
-   `lockCodeWithoutDecoration` 允许在特定装饰之外制作只读的代码部件
-   `updateEditorKeybindingsMode` 允许应用 vim 或 emacs 密钥绑定
-   `extractRangesFromTokens` 允许提取起始符和结尾符之间的代码节

### 安装

```bash
npm install @codingame/monaco-editor-wrapper
```

### 使用量

#### 简单使用

你得给暴露者打电话 `initialize` 函数,并等待返回的诺言.

然后,您就可以与 monaco- editor api 互动(通过导入) `monaco-editor`或 VSCode api(通过导入) `vscode`(中文(简体) )

#### 模型创建

而不是使用 `monaco.editor.createModel`,建议使用 `monaco.editor.createModelReference` 创建模型.

它使得VSCode服务有可能通过它的引用来引用该文件而不中断(例如当使用LSP在源代码中跟踪文件链接时).

#### 可选特征

默认情况下,只注册了最低限度的功能集(vscode扩展,编辑器/模型服务,语言,文本元件,对话框,配置/键绑定,片段,可访问性. )

可通过导入特定导出来启用一些可选特性:

-   `@codingame/monaco-editor-wrapper/features/extensionHostWorker` 允许操作 VSCode 扩展的工人扩展主机
-   `@codingame/monaco-editor-wrapper/features/notifications` 启用 VSCode 通知而不是登录控制台
-   `@codingame/monaco-editor-wrapper/features/workbench` 允许使用完整的 VSCode 工作台
-   `@codingame/monaco-editor-wrapper/features/typescriptStandalone` 允许摩纳科独立打字语言特性工作者

如果启用了工作台特性,则可使用这些特性:

-   `@codingame/monaco-editor-wrapper/features/viewPanels` 启用一些面板( 时间线、 大纲、 输出、 标记、 探索器)
-   `@codingame/monaco-editor-wrapper/features/search` 启用搜索面板
-   `@codingame/monaco-editor-wrapper/features/extensionGallery` 允许扩展通道面板和从市场安装扩展的可能性
-   `@codingame/monaco-editor-wrapper/features/terminal` 启用终端面板
-   `@codingame/monaco-editor-wrapper/features/testing` 启用测试面板

### 嵌入语言 IntelliSense

默认情况下,monaco-editor包含实现IntelliSense的工人在CSS,SCSS,JavaScript,TypeScript,JSON和HTML中.

不可能用这种自由. 然而,它们可以被相应的VSCode扩展所取代.

为了启用它们,安装和导入以下软件包:

-   贾森: `import '@codingame/monaco-vscode-json-language-features-default-extension'`
-   Java 脚本/ Type 脚本 : `import '@codingame/monaco-vscode-typescript-language-features-default-extension'`
-   支助科/支助科: `import '@codingame/monaco-vscode-css-language-features-default-extension'`
-   HTML : (英语) `import '@codingame/monaco-vscode-html-language-features-default-extension'`

您还需要导入 `@codingame/monaco-editor-wrapper/features/extensionHostWorker` 允许在网络工作员中运行 VSCode 扩展.

#### 额外的 Apis

##### 用户配置

这个库暴露了管理用户全局配置的一些功能 :

-   `registerDefaultConfigurations` 允许注册某些配置密钥的默认值, 这些密钥可以被覆盖
-   `updateUserConfiguration` 更新用户配置, 覆盖默认配置, 使用与 VS 代码配置相同的语法
-   `getUserConfiguration` 获取当前用户配置
-   `onUserConfigurationChange` 当用户配置发生变化时(在调用用户配置后或从内部配置更新中)得到通知
-   `getConfiguration` 允许在给定语言中获取给定配置密钥
-   `onConfigurationChanged` 监听配置更改
-   `updateKeybindings` a 以 VS 代码中相同的语法更新编辑器密钥
-   `updateEditorKeybindingsMode` 切换到 `vim`, (中文(简体) ), `emacs` 或者说 `classic` 密钥绑定

## 常见问题

### @codingame/monaco-editor-wrapper 是什么？

配置有工具和扩展名的 monaco- vscode- api

### 如何安装 @codingame/monaco-editor-wrapper？

在项目目录运行 npm install @codingame/monaco-editor-wrapper，或使用 pnpm add / yarn add / bun add。

### @codingame/monaco-editor-wrapper 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @codingame/monaco-editor-wrapper 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @codingame/monaco-editor-wrapper 可以商用吗？

@codingame/monaco-editor-wrapper 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @codingame/monaco-editor-wrapper 的下载量有多少？

根据 npm 官方下载统计，@codingame/monaco-editor-wrapper 在 2026/10/10 – 2026/11/08 这 30 天内被下载 4,923 次，日均约 164 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @codingame/monaco-editor-wrapper 还在维护吗？

最新版本 36\.0\.0 发布于 2026/11/06（3 天前）；至今共发布 197 个版本，其中过去 12 个月发布了 25 个；首次发布于 2021/11/10。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。