大数据文摘作品 转载具体要求见文末

选文|Aileen 翻译|徐宇文，周冲 校对|姚佳灵

R语言是一种主要应用于统计计算和可视化的高级编程语言。发布这份R语言编程格式指南的主要目的是让我们的R代码更容易阅读、分享和验证。以下这份规范是谷歌的整个R用户社区协作设计的。

◆ ◆ ◆

总结：R格式规范

1. 文件名：以.R结束

2. 标识符：variable.name (或 variableName), FunctionName, kConstantName

3. 单行长度限制：至多80个字符

4. 缩进：两个空格，不要使用“tab”

5. 空格

6. 花括号：左花括号在同一行上，右花括号另起一行

7. else：else的前后都是花【资源之家】每日免费更新最热门的副业项目资源括号

8. 赋值：使用“<-”,而不是“=”

9. 分号：不要使用

10. 整体布局和顺序

11. 注释准则：所有的注释都应该以#开头并且紧跟一个空格，如果注解与代码在同一行内，那么在#之前需加两个空格

12. 函数的定义和调用

13. 函数文档

14. 函数示例

15. TODO格式：（TODO（用户名））

◆ ◆ ◆

R语言规则

1. attach：避免使用

2. 函数：用stop命令引发出错

3. 对象和方法：尽量避免使用S4对象和方法；不要将S3和S4混用

符号与命名

文件名

文件名应该以.R结尾，而且文件的命名应该具有实际意义

好的例子——predict_ad_revenue.R

不好的例子——foo.R

标识符

不要在标识符中使用下划线（_）【资源之家】每日免费更新最热门的副业项目资源或者连接符（-）。标识符应该遵照以下约定来命名。变量名的首选形式是全部采用小写字母并且用小数点（.）来区分词（variable.name），但是variableName也是可以接受的；函数名首字母要大写并且不带有小数点（FunctionName）；常量和函数名类似，但以k开头。

首选variable.name，variableName也可以接受

好的例子：avg.clicks

可接受的例子： avgClicks

不好的例子： avg_Clicks

函数名 FunctionName

好的例子：CalculateAvgClicks

不好的例子: calculate_avg_clicks , calculateA【资源之家】每日免费更新最热门的副业项目资源vgClicks

函数名应该用动词形式表示。

例外：当创建一个类对象，函数名（构造的）和类应该相互匹配（例如：lm）

常量：kConstantName

语法

单行长度

单行的最大长度为80个字符

缩进

在缩进代码的时候，用两个空格。千万不要用tab或者把tab和空格混合使用。

例外：当圆括号里的内容出现分行的情况时，对准括号里的行首与换行的第一个字符。

空格

在所有二元运算符(=， +， -，<-，等等)的前后都加上一个空格

例外：

①调用函数传递参数时，“=”前后的空格可加可不加；

②逗号前面不要有空格，但是逗号后面要带一个空格。

好的例子——

不好的例子——

除非是调用函数，其余情况下应该在左圆括号前加上一个空格

好的例子—【资源之家】每日免费更新最热门的副业项目资源—

if (debug)

不好的例子——

if(debug)

如果加上额外的空格（也就是说在一行中超过一个空格）能够使等号或者箭头看起来更整齐，那也是可以的。

不要在圆括号或者方括号里面的代码前后加上空格

例外：

在逗号后面总是要加一个空格

花括号

左花括号不能单独成行；右花括号一定要单独成行。可以在只有一个语句的代码模块里省略花括号； 但是必须保持对所有的单个语句的代码的一致性。

也可以写成：

一个模块的语句总是另起一行

不好的例子——

else前后的花括号

else语句应该总是在同一行中被花括号围绕着

if (condition) {

one or more lines

} else {

one or more lines

}【资源之家】每日免费更新最热门的副业项目资源

不好的例子——

不好的例子——

赋值

Use <-, not =, for assignment.

用“<-”来赋值，而不是等号“=”。

好的例子——

x <- 5

坏的例子——

x = 5

分号

不要用分号作为行的结束，或者利用分号在一行中写上多个命令。（分号是不必要的，根据其它Google格式指南的一致性，可以省略）

组织

◆ ◆ ◆

总体布局和顺序

如果每一个人都使用通用的顺序，那么我们将更快及更容易地阅读和理解其他人的脚本。

1. 版本声明注释

2. 作者信息

3.文件描述注释，包括程序的功能、输入和输出

4.Source 和 library声明

5.函数定义

6.执行语句声明，如果适用的话（如：print，plot）

单元测【资源之家】每日免费更新最热门的副业项目资源试应该在一个名为originalfilename_test.R 的单独文件中。

◆ ◆ ◆

注释指南

注释代码——①必需以“#”及一个空格开始注释行；②可以在代码之后加上两个空格，然后以“#”及一个空格开始一个短小的注释。

◆ ◆ ◆

函数定义和调用

函数定义首先列出不带默认值的参数，随后是带默认值的参数。在函数定义和调用中，一行可以有多个参数；赋值语句之间可以换行。

理想情况下，单元测试应该作为样本函数调用（共享库路径）。

◆ ◆ ◆

函数文档

函数应该包含紧接着函数定义行的一个注释部分。这些注释应该包含用一句话完成的函数的描述；函数的参数列表，记作Args以及每个参数的描述（包括数据类型）；返回值的描述，记作【资源之家】每日免费更新最热门的副业项目资源Returns。注释应该描述得足够清楚，调用者可以不用看函数代码就使用它。

函数示例

◆ ◆ ◆

TODO风格

在代码中始终用相同的TODO风格

TODO(username):明确说明要采取的行动

语言

附加

使用attach出现错误的可能性很高。避免使用。

函数

用stop引发出错

◆ ◆ ◆

对象和方法

S语言有两个对象系统，S3和S4，它们在R中都是可用的。S3是更加交互式的和灵活的，而S4是更加正式的和严格的。（这两个系统的说明，参考Thomas Lumley的《Programmer’s Niche: A Simple Class, in S3 and S4 in R》）

用S3的对象和方法，除非有强烈的理由要使【资源之家】每日免费更新最热门的副业项目资源用S4的对象或方法。用S4对象的一个主要理由是在C++代码中直接使用对象。用S4通用/方式的一个主要根据是由两个参数调度。

避免混合使用S3和S4：S4方法忽略S3的继承，反之亦然。

例外——

上面描述的代码约定应该遵循，除非有一个合理的原因使用其它约定。例外包括正常的代码和修改的第三方代码。

◆ ◆ ◆

临别赠言

利用常识，保持一致。

如果你正在编写代码，花一点时间看看你的代码来决定代码风格。如果其他人在他们的if语句周围使用空格，那么你也应该这样做。如果他们的注释用星号框起来，那么你也要这样做。

有风格指南的一个关键是有一个通用的编码词汇表，这样，人们可以关注你所说的，而不是你怎么说。我们在此呈现全局的风【资源之家】每日免费更新最热门的副业项目资源格规则，这样，人们知道这么一个词汇表。但是局部风格也是重要的。如果加入文件的代码看上去和它周围的代码格格不入，这种不连续性将会打乱阅读的节奏，尽量避免出现这样的情况。

好了，关于书写代码写得足够多了；代码本身更有意思。祝编程开心！

关于转载

如需转载，请在开篇显著位置注明作者和出处（转自：大数据文摘|bigdatadigest），并在文章结尾放置大数据文摘醒目二维码。无原创标识文章请按照转载要求编辑，可直接转载，转载后请将转载链接发送给我们；有原创标识文章，请发送【文章名称-待授权公众号名称及ID】给我们申请白名单授权。未经许可的转载以及改编者，我们将依法追究其法律责任。联系邮箱：zz@bigdat【资源之家】每日免费更新最热门的副业项目资源adigest.cn。

◆ ◆ ◆

志愿者介绍

大数据文摘后台回复“志愿者”，了解如何加入我们

◆ ◆ ◆

五个技巧教你用编程实现数据可视化