R語(yǔ)言代碼風(fēng)格規(guī)范
1?文件命名
文件名:代碼文件(腳本:保存代碼的文本文件)以.R結(jié)尾晾虑,數(shù)據(jù)文件以.RData結(jié)尾千诬,文件名要有意義娱据;命名時(shí)不要有特殊字符和空格蚪黑,建議用小寫(xiě),可用下劃線分隔單詞中剩;
變量名:推薦以小寫(xiě)字母命名忌穿,用點(diǎn).
分隔所有的小寫(xiě)字母或單詞,如varible.name结啼;也接受小寫(xiě)起始接著大寫(xiě)的形式掠剑,如varibleName;命名時(shí)避免與已存在的變量或函數(shù)名重復(fù)郊愧。
函數(shù)名:推薦首字母大寫(xiě)而不用點(diǎn)朴译,如FunctionName;在命名時(shí)應(yīng)避免與R內(nèi)置的函數(shù)名重復(fù)属铁。
2 代碼書(shū)寫(xiě)規(guī)范
賦值用
<-
眠寿,快捷鍵:Alt + -
;賦值符號(hào)前后一定要有空格焦蘑,a <- b盯拱,b賦值給a;在函數(shù)中進(jìn)行參數(shù)傳遞時(shí)用
=
例嘱;逗號(hào)前不加空格狡逢,但逗號(hào)后一定要空一格,a, b拼卵;
不要在方括號(hào)或圓括號(hào)中的代碼兩側(cè)加入空格奢浑;花括號(hào)中
{
永遠(yuǎn)不應(yīng)該獨(dú)占一行;}
應(yīng)當(dāng)總是獨(dú)占一行腋腮。您可以在代碼塊只含單個(gè)語(yǔ)句時(shí)省略花括號(hào)雀彼;但在處理這類單個(gè)語(yǔ)句時(shí),必須前后一致地要么全部使用花括號(hào)低葫,或者全部不用花括號(hào)详羡。在
+, -, >, =
等運(yùn)算符前后要有空格,a + b嘿悬,a加b实柠;函數(shù)括號(hào)前后不要有空格;select(a, b)善涨;
每行代碼最長(zhǎng)不超過(guò)80個(gè)字符窒盐,可在Rstudio中通過(guò)Tools - Global Options - Code - Display然后勾選 Show margin顯示80個(gè)字符寬度的邊界線草则;要換行時(shí)在逗號(hào)后進(jìn)行換行,函數(shù)參數(shù)盡可能豎直方向?qū)R蟹漓;
ggplot2每個(gè)圖層的語(yǔ)句要單獨(dú)一行炕横,縮進(jìn)兩個(gè)空格,
+
位于一行的末尾葡粒;dplyr的每個(gè)函數(shù)要單獨(dú)一行份殿,縮進(jìn)兩個(gè)空格,管道符號(hào)%>%
位于末尾嗽交;#
后面一個(gè)空格進(jìn)行整行注釋卿嘲;行內(nèi)短注釋?xiě)?yīng)在代碼后接兩個(gè)空格,#
再接一個(gè)空格夫壁。如果注釋很長(zhǎng)拾枣,可考慮多換幾次行。
參考資料:
[1] R / 代碼規(guī)范 / Google's R Style Guide,http://www.reibang.com/p/1adb5e45949f
[2] R基礎(chǔ) | R代碼風(fēng)格規(guī)范,http://www.reibang.com/p/40cb671c4121
本文使用 文章同步助手 同步