国产探花免费观看_亚洲丰满少妇自慰呻吟_97日韩有码在线_资源在线日韩欧美_一区二区精品毛片,辰东完美世界有声小说,欢乐颂第一季,yy玄幻小说排行榜完本

首頁 > 語言 > JavaScript > 正文

當前流行的JavaScript代碼風格指南

2024-05-06 16:08:43
字體:
來源:轉載
供稿:網友
這篇文章主要介紹了當前流行的JavaScript代碼風格指南,同時推薦了一款風格檢驗工具jshint,可以配合大多數的編輯器統一團隊代碼風格,需要的朋友可以參考下
 
 

JavaScript 沒有一個權威的編碼風格指南,取而代之的是一些流行的編碼風格:

復制代碼代碼如下:

Google的JavaScript風格指南(以下簡稱Google)
http://google-styleguide.googlecode.com/svn/trunk/javascriptguide.xml
NPM編碼風格(以下簡稱NPM)
https://npmjs.org/doc/coding-style.html
Felix的Node.js風格指南(以下簡稱Node.js)
http://nodeguide.com/style.html
慣用(Idiomatic)的JavaScript(以下簡稱Idiomatic)
https://github.com/rwldrn/idiomatic.js/
jQuery JavaScript風格指南(以下簡稱jQuery)
http://contribute.jquery.org/style-guide/js/
Douglas Crockford的JavaScript風格指南(以下簡稱Crockford),Douglas Crockford是Web開發領域最知名的技術權威之一,ECMA JavaScript 2.0標準化委員會委員
http://javascript.crockford.com/code.html

當然,在JavaScript語法檢查器 JSLint 和 JSHint 中也有一些默認的設置選擇。問題是,什么才是終極的、讓大多數開發者可以遵循的JavaScript編碼風格呢?下面讓我們從這6個風格指南中找出一些有共識的風格來。

 

1. 代碼風格比較

1.1 縮進

兩個空格,無需更長的縮進,無需Tab縮進:Google、NPM、Node.js、Idiomatic
Tab縮進:jQuery
4個空格:Crockford

1.2 參數和表達式之間的空格

使用緊湊型風格:Google、NPM、Node.js

復制代碼代碼如下:
project.MyClass = function(arg1, arg2) {

過多地使用空格:Idiomatic, jQuery
復制代碼代碼如下:
for ( i = 0; i < length; i++ ) {

沒有發表意見:Crockford
大部分指南中,都提醒開發者不要在語句結尾處有任何的空格。

 

1.3 代碼行長度

最多80個字符:Google、NPM、Node.js、Crockford(當在代碼塊中,除了2個空格外的其他縮進允許將函數參數與首個函數參數的位置對齊。另一種選擇是當自動換行時使用4個空格縮進,而不是2個。)
沒有發表意見:jQuery、Idiomatic

1.4 分號

始終使用分號,不依賴于隱式插入:Google、Node.js、Crockford
在某些情況下不要使用expect:NPM
沒有發表意見:jQuery、Idiomatic

1.5 注釋

遵循JSDoc約定:Google、Idiomatic
沒有發表意見:NPM、Node.js、jQuery、Crockford

1.6 引號

推薦單引號:Google、Node.js
雙引號:jQuery
沒有發表意見:NPM、Idiomatic、Crockford

1.7 變量聲明

一次聲明一個,不使用逗號:Node.js

復制代碼代碼如下:

var foo = ”;
var bar = ”;

一次聲明多個,在行結束處使用逗號分隔:Idiomatic、jQuery
復制代碼代碼如下:

var foo = “”,
bar = “”,
quux;

在行開始處使用逗號:NPM
沒有發表意見:Google、Crockford

 

1.8 大括號

在同一行使用左大括號:Google、NPM、Node.js、Idiomatic、 jQuery、Crockford

復制代碼代碼如下:
function thisIsBlock(){

NPM指南中指出,只在代碼塊需要包含下一行時使用大括號,否則不使用。

 

1.9 全局變量

不要使用全局變量:Google、Crockford(谷歌表示,全局變量命名沖突難以調試,并可能在兩個項目進行正整合時出現一些棘手的問題。為了便于共享公用的JavaScript代碼,需要制定公約來避免沖突發生。Crockford認為不應該使用隱式全局變量。)

沒有發表意見:Idiomatic、jQuery、NPM、Node.js

2 命名風格

2.1 變量命名

開始的第一個單詞小寫,之后的所有單詞首字母大寫:Google、NPM、Node.js、Idiomatic

復制代碼代碼如下:

var foo = “”;
var fooName = “”;

 

2.2 常量命名

使用大寫字母:Google、NPM、Node.js

復制代碼代碼如下:
var CONS = ‘VALUE';

沒有發表意見:jQuery、Idiomatic、Crockford

 

2.3 函數命名

開始的第一個單詞小寫,之后的所有單詞首字母大寫(駝峰式):Google、NPM、Idiomatic、Node.js(推薦使用長的、具描述性的函數名)

復制代碼代碼如下:

function veryLongOperationName
function short()..

關鍵字形式的函數命名:
復制代碼代碼如下:

function isReady()
function setName()
function getName()

沒有發表意見:jQuery、Crockford

 

2.4 數組命名

使用復數形式:Idiomatic

復制代碼代碼如下:
var documents = [];

沒有發表意見:Google、jQuery、NPM、Node.js、Crockford

 

2.5 對象和類命名

使用如下形式:Google、NPM、Node.js

復制代碼代碼如下:

var ThisIsObject = new Date;

沒有發表意見:jQuery、Idiomatic、Crockford

 

2.6 其他命名

針對長文件名和配置鍵使用all-lower-hyphen-css-case形式:NPM

3. 根據上述風格配置 .jshintrc 文件

JSHint(http://www.jshint.com/)是一個JavaScript語法和風格檢查工具,你可以用它來提醒代碼風格相關的問題。它可以很好地被集成到許多常用的編輯器中,是統一團隊編碼風格的一個很好的工具。

你可以通過JSHint文檔查看可用的選項: http://www.jshint.com/docs/#options
下面根據以上每個分類下的第一種風格來創建一個 .jshintrc 文件。你可以將它放到項目的根目錄中,JSHint-avare 代碼編輯器將會按照它來統一項目中的所有代碼風格。

復制代碼代碼如下:

{
  "camelcase" : true,
  "indent": 2,
  "undef": true,
  "quotmark": single,
  "maxlen": 80,
  "trailing": true,
  "curly": true
}

 

此外,你應該將下面的頭添加到你的 JavaScript 文件中:

復制代碼代碼如下:

/* jshint browser:true, jquery:true */

 

在 Node.js 文件中你應該添加:

復制代碼代碼如下:

/*jshint node:true */

還可以在各種 JavaScript 文件中添加下面的聲明:
復制代碼代碼如下:

‘use strict';

這將影響 JSHint 和你的 JavaScript 引擎,可能不那么兼容,但是 JavaScript 將會運行得更快。

 

4. 在提交 Git 之前自動執行 JSHint

如果你想確保所有的 JS 代碼與 .jshintrc 中定義的風格保持一致,你可以將下面的內容添加到你的 .git/hooks/pre-commit文件中,當你試圖提交任何新修改的文件到項目時會自動執行風格檢查。

 

復制代碼代碼如下:

#!/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


發表評論 共有條評論
用戶名: 密碼:
驗證碼: 匿名發表

圖片精選

主站蜘蛛池模板: 华池县| 利津县| 高台县| 宾阳县| 明光市| 揭西县| 台北市| 吉林省| 东乡族自治县| 兰溪市| 龙泉市| 阿巴嘎旗| 罗源县| 沧州市| 昭平县| 诏安县| 凉山| 大埔区| 饶平县| 云林县| 胶南市| 榕江县| 德昌县| 和平区| 平昌县| 乌拉特后旗| 邢台市| 鞍山市| 朝阳县| 绍兴市| 邳州市| 台州市| 甘德县| 乌什县| 惠东县| 行唐县| 厦门市| 颍上县| 涟水县| 东丰县| 新泰市|