ESLint于2013年6月份推出，至今4個年頭，最新版本v4.8.0。它是目前主流的用于Javascript和JSX代碼規(guī)范檢查的利器，很多大公司比如Airbnb和Google均有一套自己的Javascript編碼規(guī)范，而規(guī)范的實施背后離不開ESLint的支持。比如大名頂頂?shù)?a target="_blank" rel="nofollow">eslint-config-airbnb和eslint-config-google。為了更好的統(tǒng)一團(tuán)隊的JS編程風(fēng)格和代碼質(zhì)量。feflow官方經(jīng)過調(diào)研和探索，終于迎來了ESLint的解決方案，最核心的理念是：基于eslint:recommend做規(guī)則的定制化。
從一次生產(chǎn)事故說起
2017年4月13日，騰訊高級工程師小圣在做充值業(yè)務(wù)時，修改了蘋果iap支付配置，將JSON配置增加了重復(fù)的key。代碼發(fā)布后，有小部分使用了vivo手機(jī)的用戶反饋充值頁面白屏，無法在Now app內(nèi)進(jìn)行充值。最后問題定位是：vivo手機(jī)使用了系統(tǒng)自帶的webview而沒有使用X5內(nèi)核，解析JSON時遇到重復(fù)key報錯，導(dǎo)致頁面白屏。
類似的問題其實很多： 比如變量未定義，方法被覆蓋等等都會造成js代碼執(zhí)行時報錯。那么如何避免呢？ESLint官方提供sharable config（可共享配置），前端團(tuán)隊可以根據(jù)自身團(tuán)隊情況定制ESLint規(guī)范配置。
規(guī)則定義準(zhǔn)則
- 不重復(fù)造輪子，基于eslint:recommend配置并改進(jìn)
- 能夠幫助發(fā)現(xiàn)代碼錯誤的規(guī)則，全部開啟
- 目的是團(tuán)隊的代碼風(fēng)格統(tǒng)一，而不是限制開發(fā)體驗
eslint-config-ivweb 介紹
eslint-config-ivweb是騰訊NOW直播IVWEB團(tuán)隊的ESLint配置。目前發(fā)布初版，目前大約有130條規(guī)則，包含可能存在的錯誤、最佳實踐、變量、代碼風(fēng)格、ES6相關(guān)等5個大的規(guī)則板塊。
倉庫地址：https://github.com/feflow/eslint-config-ivweb
歡迎提交issue或者PR一起參與團(tuán)隊規(guī)則維護(hù)
部分規(guī)則說明
包含3個信息： 最左側(cè)是規(guī)則，中間是錯誤級別，右側(cè)是解釋說明含義。錯誤級別包含：error、warn和off三個級別。
更加詳細(xì)的規(guī)則說明可以前往： 規(guī)則文檔
項目接入使用
基本理念： 項目代碼太多，不影響歷史代碼。只針對有改動的代碼（.js和.jsx后綴）才進(jìn)行校驗。
第一步：添加或者修改.eslintrc.js 配置文件
module.exports = {
"env": {
"es6": true,
"browser": true,
"node": true
},
"extends": ["eslint:recommended", "ivweb"],
"globals": {
"__inline": true,
"IS_SERVER": true,
"__uri": true
}
};
有部分eslint:recommended提到的規(guī)則在ivweb中沒有提到，因此最好配合eslint:recommend一起使用。
只需要同時繼承eslint:recommend 和 ivweb 即可，確保 ivweb 放置在最后。部分eslint:recommend定義的規(guī)則有點嚴(yán)格，ivweb里面有做定制化的修改。
第二步：增加precommit的hook和eslint-config-ivweb依賴
此處我們使用husky來管理所有的Hook，同之前的commit message校驗。
{
"name": "with-lint-staged",
"version": "0.0.1",
"scripts": {
"precommit": "lint-staged"
},
"lint-staged": {
"src/*.{js,jsx}": [
"eslint --fix",
"git add"
]
},
"devDependencies": {
"eslint": "^4.8.0",
"eslint-config-ivweb": "^0.1.0",
"husky": "^0.14.3",
"lint-staged": "^4.2.3"
}
}
答疑互動
Q： 為什么不直接使用airbnb團(tuán)隊的 eslint-config-airbnb？
A： airbnb官方的規(guī)則過于龐大，有10多個規(guī)則文件。維護(hù)起來成本較高，選擇基于輕量級的 eslint:recommend 基礎(chǔ)之上定制團(tuán)隊ESLint規(guī)則更加簡單，也便于維護(hù)。
Q： 我覺得eslint-config-ivweb有些規(guī)則不太合適，怎么辦？
A： 歡迎提交issue討論或者直接提交PR。倉庫地址：https://github.com/feflow/eslint-config-ivweb
Q： 為什么使用lint-staged？
A： lint-staged只會對修改過的js文件行數(shù)進(jìn)行代碼規(guī)范檢查，不會對所有的代碼檢查，更加合理和可操作。
