當(dāng)前流行的JavaScript代碼風(fēng)格指南
JavaScript 沒有一個(gè)權(quán)威的編碼風(fēng)格指南,取而代之的是一些流行的編碼風(fēng)格:
Google的JavaScript風(fēng)格指南(以下簡(jiǎn)稱Google)
http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml
NPM編碼風(fēng)格(以下簡(jiǎn)稱NPM)
https://npmjs.org/doc/coding-style.html
Felix的Node.js風(fēng)格指南(以下簡(jiǎn)稱Node.js)
http://nodeguide.com/style.html
慣用(Idiomatic)的JavaScript(以下簡(jiǎn)稱Idiomatic)
https://github.com/rwldrn/idiomatic.js/
jQuery JavaScript風(fēng)格指南(以下簡(jiǎn)稱jQuery)
http://contribute.jquery.org/style-guide/js/
Douglas Crockford的JavaScript風(fēng)格指南(以下簡(jiǎn)稱Crockford),Douglas Crockford是Web開發(fā)領(lǐng)域最知名的技術(shù)權(quán)威之一,ECMA JavaScript 2.0標(biāo)準(zhǔn)化委員會(huì)委員
http://javascript.crockford.com/code.html
當(dāng)然,在JavaScript語(yǔ)法檢查器 JSLint 和 JSHint 中也有一些默認(rèn)的設(shè)置選擇。問題是,什么才是終極的、讓大多數(shù)開發(fā)者可以遵循的JavaScript編碼風(fēng)格呢?下面讓我們從這6個(gè)風(fēng)格指南中找出一些有共識(shí)的風(fēng)格來。
1. 代碼風(fēng)格比較
1.1 縮進(jìn)
兩個(gè)空格,無(wú)需更長(zhǎng)的縮進(jìn),無(wú)需Tab縮進(jìn):Google、NPM、Node.js、Idiomatic
Tab縮進(jìn):jQuery
4個(gè)空格:Crockford
1.2 參數(shù)和表達(dá)式之間的空格
使用緊湊型風(fēng)格:Google、NPM、Node.js
過多地使用空格:Idiomatic, jQuery
沒有發(fā)表意見:Crockford
大部分指南中,都提醒開發(fā)者不要在語(yǔ)句結(jié)尾處有任何的空格。
1.3 代碼行長(zhǎng)度
最多80個(gè)字符:Google、NPM、Node.js、Crockford(當(dāng)在代碼塊中,除了2個(gè)空格外的其他縮進(jìn)允許將函數(shù)參數(shù)與首個(gè)函數(shù)參數(shù)的位置對(duì)齊。另一種選擇是當(dāng)自動(dòng)換行時(shí)使用4個(gè)空格縮進(jìn),而不是2個(gè)。)
沒有發(fā)表意見:jQuery、Idiomatic
1.4 分號(hào)
始終使用分號(hào),不依賴于隱式插入:Google、Node.js、Crockford
在某些情況下不要使用expect:NPM
沒有發(fā)表意見:jQuery、Idiomatic
1.5 注釋
遵循JSDoc約定:Google、Idiomatic
沒有發(fā)表意見:NPM、Node.js、jQuery、Crockford
1.6 引號(hào)
推薦單引號(hào):Google、Node.js
雙引號(hào):jQuery
沒有發(fā)表意見:NPM、Idiomatic、Crockford
1.7 變量聲明
一次聲明一個(gè),不使用逗號(hào):Node.js
var foo = ”;
var bar = ”;
一次聲明多個(gè),在行結(jié)束處使用逗號(hào)分隔:Idiomatic、jQuery
var foo = “”,
bar = “”,
quux;
在行開始處使用逗號(hào):NPM
沒有發(fā)表意見:Google、Crockford
1.8 大括號(hào)
在同一行使用左大括號(hào):Google、NPM、Node.js、Idiomatic、 jQuery、Crockford
NPM指南中指出,只在代碼塊需要包含下一行時(shí)使用大括號(hào),否則不使用。
1.9 全局變量
不要使用全局變量:Google、Crockford(谷歌表示,全局變量命名沖突難以調(diào)試,并可能在兩個(gè)項(xiàng)目進(jìn)行正整合時(shí)出現(xiàn)一些棘手的問題。為了便于共享公用的JavaScript代碼,需要制定公約來避免沖突發(fā)生。Crockford認(rèn)為不應(yīng)該使用隱式全局變量。)
沒有發(fā)表意見:Idiomatic、jQuery、NPM、Node.js
2 命名風(fēng)格
2.1 變量命名
開始的第一個(gè)單詞小寫,之后的所有單詞首字母大寫:Google、NPM、Node.js、Idiomatic
var foo = “”;
var fooName = “”;
2.2 常量命名
使用大寫字母:Google、NPM、Node.js
沒有發(fā)表意見:jQuery、Idiomatic、Crockford
2.3 函數(shù)命名
開始的第一個(gè)單詞小寫,之后的所有單詞首字母大寫(駝峰式):Google、NPM、Idiomatic、Node.js(推薦使用長(zhǎng)的、具描述性的函數(shù)名)
function veryLongOperationName
function short()..
關(guān)鍵字形式的函數(shù)命名:
function isReady()
function setName()
function getName()
沒有發(fā)表意見:jQuery、Crockford
2.4 數(shù)組命名
使用復(fù)數(shù)形式:Idiomatic
沒有發(fā)表意見:Google、jQuery、NPM、Node.js、Crockford
2.5 對(duì)象和類命名
使用如下形式:Google、NPM、Node.js
var ThisIsObject = new Date;
沒有發(fā)表意見:jQuery、Idiomatic、Crockford
2.6 其他命名
針對(duì)長(zhǎng)文件名和配置鍵使用all-lower-hyphen-css-case形式:NPM
3. 根據(jù)上述風(fēng)格配置 .jshintrc 文件
JSHint(http://www.jshint.com/)是一個(gè)JavaScript語(yǔ)法和風(fēng)格檢查工具,你可以用它來提醒代碼風(fēng)格相關(guān)的問題。它可以很好地被集成到許多常用的編輯器中,是統(tǒng)一團(tuán)隊(duì)編碼風(fēng)格的一個(gè)很好的工具。
你可以通過JSHint文檔查看可用的選項(xiàng): http://www.jshint.com/docs/#options
下面根據(jù)以上每個(gè)分類下的第一種風(fēng)格來創(chuàng)建一個(gè) .jshintrc 文件。你可以將它放到項(xiàng)目的根目錄中,JSHint-avare 代碼編輯器將會(huì)按照它來統(tǒng)一項(xiàng)目中的所有代碼風(fēng)格。
{
"camelcase" : true,
"indent": 2,
"undef": true,
"quotmark": single,
"maxlen": 80,
"trailing": true,
"curly": true
}
此外,你應(yīng)該將下面的頭添加到你的 JavaScript 文件中:
/* jshint browser:true, jquery:true */
在 Node.js 文件中你應(yīng)該添加:
/*jshint node:true */
還可以在各種 JavaScript 文件中添加下面的聲明:
‘use strict';
這將影響 JSHint 和你的 JavaScript 引擎,可能不那么兼容,但是 JavaScript 將會(huì)運(yùn)行得更快。
4. 在提交 Git 之前自動(dòng)執(zhí)行 JSHint
如果你想確保所有的 JS 代碼與 .jshintrc 中定義的風(fēng)格保持一致,你可以將下面的內(nèi)容添加到你的 .git/hooks/pre-commit文件中,當(dāng)你試圖提交任何新修改的文件到項(xiàng)目時(shí)會(huì)自動(dòng)執(zhí)行風(fēng)格檢查。
#!/bin/bash
# Pre-commit Git hook to run JSHint on JavaScript files.
#
# If you absolutely must commit without testing,
# use: git commit --no-verify
filenames=($(git diff --cached --name-only HEAD))
which jshint &> /dev/null
if [ $? -ne 0 ];
then
echo "error: jshint not found"
echo "install with: sudo npm install -g jshint"
exit 1
fi
for i in "${filenames[@]}"
do
if [[ $i =~ \.js$ ]];
then
echo jshint $i
jshint $i
if [ $? -ne 0 ];
then
exit 1
fi
fi
done
- 快速設(shè)置IDEA代碼風(fēng)格為Google風(fēng)格
- eslint+prettier統(tǒng)一代碼風(fēng)格的實(shí)現(xiàn)方法
- 配置eslint規(guī)范項(xiàng)目代碼風(fēng)格
- 實(shí)例詳解Vue項(xiàng)目使用eslint + prettier規(guī)范代碼風(fēng)格
- 如何使用 Pylint 來規(guī)范 Python 代碼風(fēng)格(來自IBM)
- Pycharm學(xué)習(xí)教程(2) 代碼風(fēng)格
- php好代碼風(fēng)格的階段性總結(jié)
- .Net 項(xiàng)目代碼風(fēng)格要求小結(jié)
- 你應(yīng)該知道的Ruby代碼風(fēng)格
- 關(guān)于更改Zend Studio/Eclipse代碼風(fēng)格主題的介紹
- JQuery入門—JQuery程序的代碼風(fēng)格詳細(xì)介紹
- Java黑科技之通過Google Java Style 文件配置IDEA和Ecplise代碼風(fēng)格
相關(guān)文章
JS中append字符串包含onclick無(wú)效傳遞參數(shù)失敗的解決方案
這篇文章主要介紹了JS中append字符串包含onclick無(wú)效傳遞參數(shù)失敗的解決方案,需要的朋友可以參考下2016-12-12
JavaScript時(shí)間格式整理大全(附大量示例)
在JavaScript中時(shí)間格式轉(zhuǎn)換是一個(gè)常見的需求,可以通過多種方式實(shí)現(xiàn),這篇文章主要介紹了JavaScript時(shí)間格式的相關(guān)資料,文中通過代碼介紹的非常詳細(xì),需要的朋友可以參考下2025-04-04
小程序顯示彈窗時(shí)禁止下層的內(nèi)容滾動(dòng)實(shí)現(xiàn)方法
這篇文章主要介紹了小程序顯示彈窗時(shí)禁止下層的內(nèi)容滾動(dòng)實(shí)現(xiàn)方法,小編覺得挺不錯(cuò)的,現(xiàn)在分享給大家,也給大家做個(gè)參考。一起跟隨小編過來看看吧2019-03-03
js彈性勢(shì)能動(dòng)畫之拋物線運(yùn)動(dòng)實(shí)例詳解
這篇文章主要為大家詳細(xì)介紹了js彈性勢(shì)能動(dòng)畫之拋物線運(yùn)動(dòng)的制作方法,具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2017-07-07
javascript實(shí)現(xiàn)九宮格相加數(shù)值相等
這篇文章主要介紹了javascript實(shí)現(xiàn)九宮格相加數(shù)值相等的相關(guān)資料,文中示例代碼介紹的非常詳細(xì),具有一定的參考價(jià)值,感興趣的小伙伴們可以參考一下2016-02-02
詳解addEventListener的三個(gè)參數(shù)之useCapture
本文主要給大家介紹的是addEventListener的三個(gè)參數(shù)之中的useCapture參數(shù)的使用及示例分享,有需要的小伙伴參考下2015-03-03
JS實(shí)現(xiàn)同一個(gè)網(wǎng)頁(yè)布局滑動(dòng)門和TAB選項(xiàng)卡實(shí)例
這篇文章主要介紹了JS實(shí)現(xiàn)同一個(gè)網(wǎng)頁(yè)布局滑動(dòng)門和TAB選項(xiàng)卡效果,通過簡(jiǎn)單的自定義切換函數(shù)setTab實(shí)現(xiàn)頁(yè)面元素的遍歷及屬性切換的功能,具有一定參考借鑒價(jià)值,需要的朋友可以參考下2015-09-09
javascript創(chuàng)建函數(shù)的20種方式匯總
這篇文章主要介紹了javascript創(chuàng)建函數(shù)的20種方式匯總的相關(guān)資料,需要的朋友可以參考下2015-06-06
JS實(shí)現(xiàn)設(shè)置ff與ie元素絕對(duì)位置的方法
這篇文章主要介紹了JS實(shí)現(xiàn)設(shè)置ff與ie元素絕對(duì)位置的方法,涉及JavaScript針對(duì)頁(yè)面元素及元素屬性的相關(guān)操作技巧,需要的朋友可以參考下2016-03-03
淺析JavaScrip哪些操作會(huì)造成內(nèi)存泄露以及預(yù)防方法
在?JavaScript?中,內(nèi)存泄露是指程序不再使用的內(nèi)存沒有被釋放,從而導(dǎo)致內(nèi)存的持續(xù)增長(zhǎng),最終可能導(dǎo)致性能下降或應(yīng)用崩潰,本文整理了一些容易造成內(nèi)存泄漏的操作以及預(yù)防方法,需要的可以了解下2024-12-12

