编程风格指南

标识符和命名

文件名应该有意义,并且以.R 结尾。
#好
fit-models.R 
utility-functions.R
# 不好
foo.r
stuff.r
如果文件需要按照顺序执行,则在文件名上加上数字前缀:
0-download.R 
1-parse.R 
2-explore.R

对象名

变量名和函数名应该是小写的。 使用下划线(_)分隔名字中的单词。 一般来说,变 量名应该是名词,函数名应该是动词。 尽量把名字取得简洁而有意义 (这并不容 易!)。

#好
day_one
day_1
# 不好 first_day_of_the_month DayOne
dayone
djm1
# 不好
T <- FALSE
c <- 10
mean <- function(x) sum(x)
 

只要有可能,就应该避免使用现有的函数和变量的名字。 否则,将导致读者迷惑。

语法

在中缀操作符(=, +, -, <-等)两边都留空格。 在函数调用里使用=时,也使用同样的 规则。 总是在逗号后面留一个空格,而逗号前面则不要留(就像普通英语文章那 样)。

#好
average <- mean(feet / 12 + inches, na.rm = TRUE)
# 不好 average<-mean(feet/12+inches,na.rm=TRUE)```

这条规则有一个例外——在::和:::的两边都不要留空格

#好
x <- 1:10 base::get
# 不好
x <- 1 : 10 base :: ge

除了函数调用以外,在左括号前面留一个空格。

#好
if (debug) do(x)
plot(x, y)
# 不好 if(debug)do(x) plot (x, y)
 

如果可以对齐等式或者赋值表达式(<-),留有一些额外的空格(比如,在一行中多 于一个空格)也是可以的。

list(
total = a + b + c, mean = (a + b + c) / n )

不要在圆括号或者方括号内的代码两边留空格(除非有逗号,看前述关于逗号的规则)
如果可以对齐等式或者赋值表达式(<-),留有一些额外的空格(比如,在一行中多 于一个空格)也是可以的。
不要在圆括号或者方括号内的代码两边留空格(除非有逗号,看前述关于逗号的规
则)

list(
total = a + b + c, mean = (a + b + c) / n )

你可能感兴趣的:(编程风格指南)