不喜欢广告? 去 无广告 今天
R代码格式化器(Styler / Tidyverse风格)
开发人员文本
广告 移除?
广告 移除?
指导
立即按照 tidyverse 风格格式化 R 代码
R 代码格式化工具会将您浏览器中的任意 R 脚本应用 tidyverse 和 styler 的规范。粘贴您的代码,工具将自动修复赋值箭头、比较运算符、管道运算符(如 <- )周围的空格,缩进嵌套块,并标记任何超出您设定长度的行。所有操作都在您的设备上本地运行,因此您的代码不会离开页面。 %>% 且 |>将您的 R 源代码粘贴到输入区域,或使用文件选择器上传一个
如何使用
- 文件。
.R选择缩进宽度(2个空格是 tidyverse 的默认值;4个空格也受支持)。 - 设置最大行长度,以便工具可以标记任何超出限制的行。
- 切换是否将顶层
- 赋值重写为
=(函数调用中的命名参数始终保持不变)。<-复制格式化后的输出或将其下载为一个 - tidyverse 缩进
.R文件。
特征
- ——在二元运算符、比较运算符和管道两侧插入一个空格;保持 紧密。
$,::且@可配置的缩进宽度 - ——选择用于嵌套块、函数体和多行参数列表的 2 或 4 个空格。 长行检测
- ——标记所有超出配置最大长度的行(默认为80个字符)。 赋值规范化
- ——可选择将顶层 赋值重写为
=,而不影响函数调用中的命名参数。<-语法一致性检查 - ——检测括号、方括号和大括号的不平衡情况,以及未终止的字符串。 注释和字符串安全
- ——解析器会保护注释文本、普通字符串、原始字符串( )和反引号引号标识符,防止它们被重新格式化。
r"(...)"清理由合作者遗留或由旧工具生成的 R 脚本。
常见用例
- 为数据可视化或 Shiny 应用代码准备代码审查。
- 在发布前标准化教程或博客文章中的代码片段。
- 检查 Quarto、R Markdown 或 Jupyter 笔记本中生成的 R 代码块。
- 在合并前快速检查脚本中是否存在过长的行。
- 什么是 tidyverse 风格指南?
常问问题
-
tidyverse 风格指南是一套由社区维护的 R 编码规范,最初源自 Google 的 R 风格,并由 Hadley Wickham 进一步完善。它规定了命名、缩进、行长度、赋值运算符选择等格式规则,以确保不同作者编写的 R 代码在外观和可读性上保持一致。
为什么 tidyverse 偏好使用赋值箭头 <- 而不是 =?
-
R 支持 <- 和 = 两种赋值方式,但在某些上下文中行为略有不同。= 也被用于绑定函数参数,因此在阅读代码时可能会产生歧义,不清楚某个标识符是被定义还是作为参数传递。而 <- 箭头具有单一明确的含义,更清晰地表达了意图,并且与 R 自诞生以来一直使用的解析规则保持一致。
%>% 和 |> 有什么区别?
-
%>% 是 magrittr 包提供的管道运算符,最初由 dplyr 推广流行。|> 是 R 4.1 版本中引入的原生管道运算符。两者外观相似,但 %>% 是一个函数调用,支持占位符语法(如 .)和赋值管道 %%,而 |> 是一个轻量级的解析层重写,速度更快且没有外部依赖。两者在 tidyverse 规则下都会在两侧添加空格。
为什么 80 个字符是常规的最大行长度?
-
80 列的惯例起源于穿孔卡片和早期终端,但至今仍被保留,因为它能确保代码在并排差异对比中保持可读性,适用于较小的笔记本屏幕以及打印材料。许多项目今天已将其放宽至 100 或 120 个字符,但 tidyverse 和 styler 默认为 80,以保持与最广泛编辑器和审查工具的兼容性。
在此粘贴您的 R 代码...
