# @davisvaughan/tree-sitter-r 中文文档

规范地址：https://npmcn.com/package/%40davisvaughan/tree-sitter-r/

版本：1\.3\.0
npm 元数据更新时间：2026-06-19T17:57:46.275Z
中文译文更新时间：2026-11-11T16:16:26.428Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40davisvaughan/tree-sitter-r
原文对照：https://npmcn.com/package/%40davisvaughan/tree-sitter-r/?lang=original
项目主页：https://github.com/r-lib/tree-sitter-r#readme
源码仓库：https://github.com/r-lib/tree-sitter-r

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

- 包体积（解压后）：8.1 MB，27 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- peer 依赖：tree-sitter ^0\.21\.1
- 首次发布：2025-06-06T14:51:04.554Z
- 最新版本发布：2026-06-19T17:57:46.128Z
- 近 30 天下载量：91584（2026-10-12 至 2026-11-10，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 1 个）

## 中文简介

树保姆的语法 R

## 安装

```sh
npm install @davisvaughan/tree-sitter-r
```

也可以使用：`pnpm add @davisvaughan/tree-sitter-r`、`yarn add @davisvaughan/tree-sitter-r`、`bun add @davisvaughan/tree-sitter-r`

## README

# 树保姆-r

R 语法 [植树人](https://github.com/tree-sitter/tree-sitter)。 。 。 .

## R 软件包

这个语法是作为 [R 软件包](https://cran.r-project.org/web/packages/treesitter.r/index.html)。 。 。 .

你也会喜欢的 [R 包件, 向树保姆提供约束](https://davisvaughan.github.io/r-tree-sitter/) 自己来.

## 粗口装订

这个语法是作为 [木箱上的破碎箱子 io](https://crates.io/crates/tree-sitter-r)。 。 。 .

## 节点绑定

这个语法是作为 [npm 软件包](https://www.npmjs.com/package/@davisvaughan/tree-sitter-r)。 。 。 .

请注意,它目前被列在名称下的范围包中 `@davisvaughan/tree-sitter-r`。 。 。 . 我们正与Npm团队合作 以获得所有权 `tree-sitter-r` 软件包. 一旦发生这种情况,我们将移动 npm 包在那里取而代之.

## 参考资料

-   [R 样本草稿](https://cran.r-project.org/doc/manuals/r-release/R-lang.pdf)
-   [语法](https://github.com/wch/r-source/blob/trunk/src/main/gram.y)

## 已知偏差数

本节介绍已知的与R语法的偏差.

### `]]` 作为字面符号

以下为有效的 R 语法, 注意 `]]` 已被分拆为多行.

```r
x[["a"]
]
```

这适用于 `]]`,但不会 `[[`例如,这不是有效的 R 语法 :

```r
x[
["a"]]
```

其技术原因是 [语法中](https://github.com/wch/r-source/blob/988774e05497bcf2cfac47bfbec59d551432e3fb/src/main/gram.y#L508) R 处理 `[[` 作为单一的象征,但 `]]` 被作为两个个人对待 `]` 标志. 治疗 `]]` 两人 `]` 符号允许在二者之间出现白空格、新行甚至注释 `]` 符号 :

```r
x[["a"] # comment
]
```

虽然我们想准确支持R语法,但对待所有 `(`, (中文(简体) ), `)`, (中文(简体) ), `[`, (中文(简体) ), `]`, (中文(简体) ), `[[`,以及 `]]` 在使用树保姆语法时作为字面符号. 这使得您可以以同样的方式对待调用,子集和子集2节点,因为它们都具有完全相同的节点结构.

因为治疗 `]]` 因为我们从未见过"野外"的R代码 这样写,这个语法不允许 白空间,新行,或两者之间的评论 `]` 标志.

## 常见问题

### @davisvaughan/tree-sitter-r 是什么？

树保姆的语法 R

### 如何安装 @davisvaughan/tree-sitter-r？

在项目目录运行 npm install @davisvaughan/tree-sitter-r，或使用 pnpm add / yarn add / bun add。

### @davisvaughan/tree-sitter-r 支持 TypeScript 吗？

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

### @davisvaughan/tree-sitter-r 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @davisvaughan/tree-sitter-r 可以商用吗？

@davisvaughan/tree-sitter-r 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @davisvaughan/tree-sitter-r 的下载量有多少？

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

### @davisvaughan/tree-sitter-r 还在维护吗？

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