用途:这是 Google 官方发布的 R 编码规范,面向数据分析、R 包开发和代码评审,目标是让 R 代码保持一致、易读、易维护,也用于团队新人上手。
主要能力与规则要点:
- 命名:函数与变量用 snake_case,如 calculate_mean、user_count;常量用 UPPER_SNAKE_CASE,如 MAX_ITERATIONS。
- 命名应表达含义,说明“做什么”而非“怎么做”。
- 每行不超过 80 字符。
- 注释要解释原因而非复述代码。
- 使用 roxygen2 编写函数文档。
- 尽量避免全局状态,函数在可能时应保持纯粹。
- 推荐使用 tidyverse 的统一、现代写法。
示例(来自资料):calculate_user_stats <- function(users, min_age = 18) { users %>% filter(age >= min_age) %>% summarize(count = n(), avg_age = mean(age)) }。
适用场景:编写新的 R 代码、数据分析脚本、R 包开发、代码评审、新成员入职。
使用方式:可通过命令安装技能,npx skills add testdino-hq/google-styleguides-skills/r;完整细节、示例与边界情况见 r.md。
限制:资料仅提供预览内容,完整规范细节、边界情况与其余条款暂未提供;资料未说明收费、价格、平台或运行环境要求。