# @arborium/arborium 中文文档

规范地址：https://npmcn.com/package/%40arborium/arborium/

版本：2\.18\.2
npm 元数据更新时间：2026-08-28T15:17:46.005Z
中文译文更新时间：2026-11-06T13:47:54.014Z
软件包许可：MIT OR Apache-2\.0

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

原始 npm 页面：https://www.npmjs.com/package/%40arborium/arborium
原文对照：https://npmcn.com/package/%40arborium/arborium/?lang=original
项目主页：https://github.com/bearcove/arborium
源码仓库：https://github.com/bearcove/arborium

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

- 包体积（解压后）：482 kB，52 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- 运行依赖：0 个
- 首次发布：2025-12-04T17:30:19.733Z
- 最新版本发布：2026-08-28T15:17:45.683Z
- 近 30 天下载量：15123（2026-10-07 至 2026-11-05，npm 官方下载统计）
- 已发布版本数：44（近 12 个月 44 个）

## 中文简介

高性能语法,由树保姆和WebAssembly提供电源

## 安装

```sh
npm install @arborium/arborium
```

也可以使用：`pnpm add @arborium/arborium`、`yarn add @arborium/arborium`、`bun add @arborium/arborium`

## README

# @ arborium/ arborium

高性能语法强调由树保姆和Web Assembly提供动力.

[![npm](https://img.shields.io/npm/v/@arborium/arborium)](https://www.npmjs.com/package/@arborium/arborium) [![License](https://img.shields.io/npm/l/@arborium/arborium)](https://github.com/bearcove/arborium)

## 安装

```bash
npm install @arborium/arborium
```

## 使用量

### 备选案文1:投稿(最轻松)

添加一个单一脚本标签和 Arborium 自动高亮灯所有代码块 :

```html
<script src="https://cdn.jsdelivr.net/npm/@arborium/arborium/dist/arborium.iife.js"></script>
```

就这样! ium会:

-   自动检测语言 `class="language-*"` 或者说 `data-lang="*"` 属性
-   从 jsDelivr CDN 按需装入语法 WASM 插件
-   输入默认主题 CSS

**通过数据属性配置 :**

```html
<script
  src="https://cdn.jsdelivr.net/npm/@arborium/arborium/dist/arborium.iife.js"
  data-theme="tokyo-night"
  data-selector="pre code"
></script>
```

### 备选方案2:无害环境管理模块(方案)

```typescript
import { loadGrammar, highlight } from '@arborium/arborium';

// Load a grammar (fetched from CDN on first use)
const grammar = await loadGrammar('rust');

// Highlight code
const html = grammar.highlight('fn main() { println!("Hello!"); }');

// Or use the convenience function
const html = await highlight('rust', code);
```

## 主题

本套装包括了33个内置主题. 单独导入:

```html
<link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@arborium/arborium/dist/themes/tokyo-night.css">
```

或在 JavaScript 中导入 :

```javascript
import '@arborium/arborium/themes/tokyo-night.css';
```

### 可用主题

**黑暗主题 :** 花花花花 花花花花 花花花 花花花 花花花花 花花花花 花花花花 花花花花 花花花花 花花花 花花花 花花花 花花 花花花 花花 花花花 花花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花 花

**轻主题 :** 黄花相接灯、花花相接灯、花花相接灯、花花相接灯、花花相接灯、花花相接灯、花花相接灯、花花相接灯、花花相接灯

## 主题归属

所有主题都是从原来的项目中改编出彩色方案. 我们感谢最初的主题作者:

| 主题 | 来源 |
| --- | --- |
| 阿难 | [主题/颜色](https://github.com/ayu-theme/ayu-colors) |
| 猫头鹰 | [猫用/猫用](https://github.com/catppuccin/catppuccin) |
| 钴2 | [wesbos/cobalt2-vscode (英语)](https://github.com/wesbos/cobalt2-vscode) |
| 戴福克斯语Name | [伊甸园东部/夜狐.nvim](https://github.com/EdenEast/nightfox.nvim) |
| 沙漠256 | [活字标记/沙漠256.vim](https://github.com/vim-scripts/desert256.vim) |
| 德古拉 | [德拉库拉主题.com](https://draculatheme.com/) |
| 埃夫·梅丽莎 | [protesilaos.com/emacs/ef-主题](https://protesilaos.com/emacs/ef-themes) |
| GitHub 图像 | [入门/github-vscode-主题](https://github.com/primer/github-vscode-theme) |
| 格鲁弗盒 | [莫赫兹/格鲁弗盒](https://github.com/morhetz/gruvbox) |
| 神奈川岛 | [叛军/kanagawa.nvim](https://github.com/rebelot/kanagawa.nvim) |
| 光猫头鹰 | [斯德拉斯/夜间猫头鹰-vscode-主题](https://github.com/sdras/night-owl-vscode-theme) |
| 卢修斯 | [乔纳坦菲利普/维姆-卢西乌斯](https://github.com/jonathanfilip/vim-lucius) |
| 美兰 | [savq/melange-nvim (英语)](https://github.com/savq/melange-nvim) |
| 莫诺凯 | [单端](https://monokai.pro/) |
| 北部 | [诺德主题.com](https://www.nordtheme.com/) |
| 一个黑暗 | [原子/一深语法](https://github.com/atom/one-dark-syntax) |
| 罗塞松 | [互联网档案馆的存檔,存档日期2013-12-02. rosepine主题.com](https://rosepinetheme.com/) |
| 罗斯多克语Name | [生锈/锈](https://github.com/rust-lang/rust/tree/master/src/librustdoc/html/static/css/themes) |
| 太阳能化 | [ethanschoonover.com/已关闭](https://ethanschoonover.com/solarized/) |
| 东京之夜 | [enkia/tokyo- night-vscode-主题](https://github.com/enkia/tokyo-night-vscode-theme) |
| 禅本 | [jnurmine/Zenburn (日语)](https://github.com/jnurmine/Zenburn) |
| 阿拉巴斯特语Name | [吨基/vscode-主题阿拉贝斯特](https://github.com/tonsky/vscode-theme-alabaster) |

## 链接

-   [GitHub 仓库](https://github.com/bearcove/arborium)
-   [文档](https://arborium.bearcove.eu/)
-   [碎屑(ium)](https://crates.io/crates/arborium)

## 许可证

麻省理工学院或阿帕奇2.0

捆绑的主题是从各自的项目中修改颜色方案。 请查看每个项目的具体许可条款的存储库.

## 常见问题

### @arborium/arborium 是什么？

高性能语法,由树保姆和WebAssembly提供电源

### 如何安装 @arborium/arborium？

在项目目录运行 npm install @arborium/arborium，或使用 pnpm add / yarn add / bun add。

### @arborium/arborium 支持 TypeScript 吗？

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

### @arborium/arborium 支持 ESM 还是 CommonJS？

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

### @arborium/arborium 可以商用吗？

@arborium/arborium 使用 MIT OR Apache-2\.0 许可。可在 MIT、Apache-2\.0 中任选其一遵守。选择 MIT 时，宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @arborium/arborium 的下载量有多少？

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

### @arborium/arborium 还在维护吗？

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