淘寶開(kāi)源的代碼質(zhì)量檢測(cè)工具，太強(qiáng)大了?。?/h1>
點(diǎn)擊上方?java項(xiàng)目開(kāi)發(fā)，選擇?設(shè)為星標(biāo)
優(yōu)質(zhì)文章，及時(shí)送達(dá)
--
來(lái)源：github.com/ice-lab/iceworks/tree/master/
好的代碼一定是整潔的，并且能夠幫助閱讀的人快速理解和定位。好的代碼可以加快應(yīng)用的開(kāi)發(fā)迭代速度，不必花過(guò)多的時(shí)間來(lái)修復(fù) bug 和完善代碼。
好的代碼不但能夠使得新的項(xiàng)目成員更容易加入項(xiàng)目，同時(shí)方便項(xiàng)目組成員快速做好 Back up。好的代碼便于促進(jìn)團(tuán)隊(duì)間交流合作提升開(kāi)發(fā)效率。
代碼質(zhì)量評(píng)價(jià)標(biāo)準(zhǔn)
有編碼經(jīng)驗(yàn)的人對(duì)代碼都有一定的“鑒賞力”，能夠憑感覺(jué)給出代碼好壞的主觀評(píng)價(jià)。但是這種憑感覺(jué)的方式太過(guò)個(gè)性隨意，所謂仁者見(jiàn)仁智者見(jiàn)智，很難達(dá)成共識(shí)，那有沒(méi)有一種公認(rèn)的標(biāo)準(zhǔn)來(lái)鑒定代碼質(zhì)量呢？
答案是有的。這里簡(jiǎn)單分享當(dāng)下較常用的評(píng)價(jià)標(biāo)準(zhǔn)，其中包括：編碼規(guī)范、可讀性、可維護(hù)性、重復(fù)度及可測(cè)試性。
編碼規(guī)范主要包含是否遵守了最佳實(shí)踐和團(tuán)隊(duì)編碼規(guī)范，是否包含可能出問(wèn)題的代碼，以及可能存在安全的漏洞。編碼規(guī)范有助于提高團(tuán)隊(duì)內(nèi)協(xié)助的效率以及代碼的可維護(hù)性。
可讀性Code Review 是一個(gè)很好的測(cè)驗(yàn)代碼可讀性的手段。如果你的同事可以輕松地讀懂你寫(xiě)的代碼，那說(shuō)明你的代碼可讀性很好；反之則說(shuō)明你的代碼可讀性有待提高了。遵守編碼規(guī)范也能讓我們寫(xiě)出可讀性更好的代碼。
可維護(hù)性代碼的可維護(hù)性是由很多因素協(xié)同作用的結(jié)果。代碼的可讀性好、簡(jiǎn)潔、可擴(kuò)展性好，就會(huì)使得代碼易維護(hù)；更細(xì)化地講，如果代碼分層清晰、模塊化好、高內(nèi)聚低耦合、遵從基于接口而非實(shí)現(xiàn)編程的設(shè)計(jì)原則等等，那就可能意味著代碼易維護(hù)。除此之外，代碼的易維護(hù)性還跟項(xiàng)目代碼量的多少、業(yè)務(wù)的復(fù)雜程度、利用到的技術(shù)的復(fù)雜程度、文檔是否全面等諸多因素有關(guān)。
重復(fù)度遵守 Don’t Repeat Yourself 原則，盡量減少重復(fù)代碼的編寫(xiě)，復(fù)用已有的代碼。對(duì)項(xiàng)目定期進(jìn)行代碼重復(fù)度檢測(cè)是一個(gè)很有意義的事，可以幫助開(kāi)發(fā)人員發(fā)現(xiàn)冗余代碼，進(jìn)行代碼抽象和重構(gòu)。重復(fù)的代碼一旦出錯(cuò)，意味著加倍的工作量和持續(xù)的不可控。如果代碼中有大量的重復(fù)代碼，就要考慮將重復(fù)的代碼提取出來(lái)，封裝成公共的方法或者組件。
可測(cè)試性代碼可測(cè)試性的好壞，同樣可以反應(yīng)代碼質(zhì)量的好壞。代碼的可測(cè)試性差，比較難寫(xiě)單元測(cè)試，那基本上就能說(shuō)明代碼設(shè)計(jì)得有問(wèn)題。
除此之外還有很多代碼質(zhì)量評(píng)價(jià)標(biāo)準(zhǔn)。我們需要一些取舍，選取部分大家有共識(shí)的規(guī)則定義團(tuán)隊(duì)好的代碼標(biāo)準(zhǔn)。
代碼質(zhì)量維度
當(dāng)前版本通過(guò) @iceworks/doctor 從 5 個(gè)維度對(duì)代碼進(jìn)行評(píng)分：
最佳實(shí)踐：?通過(guò) @iceworks/eslint-plugin-best-practices 分析項(xiàng)目，提出符合當(dāng)前工程特征（對(duì) ice 和 Rax項(xiàng)目友好）的最佳實(shí)踐及阻塞問(wèn)題發(fā)布卡口，幫助開(kāi)發(fā)者優(yōu)化項(xiàng)目性能，避免潛在 bug 。 安全實(shí)踐：?通過(guò) @iceworks/eslint-plugin-security-practices 掃碼代碼檢測(cè)工程中可能存在的安全風(fēng)險(xiǎn)，包含 url 、敏感成詞、明文賬密信息及 npm 包證書(shū)檢測(cè)，降低項(xiàng)目安全風(fēng)險(xiǎn)，守衛(wèi)項(xiàng)目安全。 阿里代碼規(guī)范：?這一維度主要反饋開(kāi)發(fā)人員對(duì)于 eslint-config-ali 阿里開(kāi)發(fā)規(guī)約的遵守程度。 可維護(hù)度：?通過(guò) typhonjs-escomplex 對(duì)文件進(jìn)行掃碼，得出每個(gè)文件的可維護(hù)度，可讀性及復(fù)雜度評(píng)分。針對(duì)得分較差的文件可以進(jìn)行深度分析幫助開(kāi)發(fā)者更好的重構(gòu)復(fù)雜代碼。 重復(fù)度：?通過(guò) jscpd 計(jì)算重復(fù)出現(xiàn)的代碼區(qū)塊占比，計(jì)算出 clone 分?jǐn)?shù)。并逐一列舉重復(fù)的代碼，方便開(kāi)發(fā)者快速定位重復(fù)代碼，將其封裝成公共的方法或者組件。
根據(jù)上述 5 個(gè)維度通過(guò)加權(quán)平均的方式計(jì)算項(xiàng)目質(zhì)量分，并根據(jù)木桶效應(yīng)，在計(jì)算得分的過(guò)程中加大了最低分的權(quán)重，得出最終項(xiàng)目質(zhì)量評(píng)分。
項(xiàng)目地址
github地址：https://github.com/ice-lab/iceworks/tree/master/
-?END -
推薦案例
溫暖提示
為了方便大家更好的學(xué)習(xí)，本公眾號(hào)經(jīng)常分享一些完整的單個(gè)功能案例代碼給大家去練習(xí)，如果本公眾號(hào)沒(méi)有你要學(xué)習(xí)的功能案例，你可以聯(lián)系小編（微信：xxf960513）提供你的小需求給我，我安排我們這邊的開(kāi)發(fā)團(tuán)隊(duì)免費(fèi)幫你完成你的案例。
注意：只能提單個(gè)功能的需求不能要求功能太多，比如要求用什么技術(shù)，有幾個(gè)頁(yè)面，頁(yè)面要求怎么樣？
請(qǐng)長(zhǎng)按識(shí)別二維碼
想學(xué)習(xí)更多的java功能案例請(qǐng)關(guān)注
Java項(xiàng)目開(kāi)發(fā)
如果你覺(jué)得這個(gè)案例以及我們的分享思路不錯(cuò)，對(duì)你有幫助，請(qǐng)分享給身邊更多需要學(xué)習(xí)的朋友。別忘了《留言+點(diǎn)在看》給作者一個(gè)鼓勵(lì)哦
點(diǎn)擊上方?java項(xiàng)目開(kāi)發(fā)，選擇?設(shè)為星標(biāo)
優(yōu)質(zhì)文章，及時(shí)送達(dá)
--
好的代碼不但能夠使得新的項(xiàng)目成員更容易加入項(xiàng)目，同時(shí)方便項(xiàng)目組成員快速做好 Back up。好的代碼便于促進(jìn)團(tuán)隊(duì)間交流合作提升開(kāi)發(fā)效率。
代碼質(zhì)量評(píng)價(jià)標(biāo)準(zhǔn)
有編碼經(jīng)驗(yàn)的人對(duì)代碼都有一定的“鑒賞力”，能夠憑感覺(jué)給出代碼好壞的主觀評(píng)價(jià)。但是這種憑感覺(jué)的方式太過(guò)個(gè)性隨意，所謂仁者見(jiàn)仁智者見(jiàn)智，很難達(dá)成共識(shí)，那有沒(méi)有一種公認(rèn)的標(biāo)準(zhǔn)來(lái)鑒定代碼質(zhì)量呢？
答案是有的。這里簡(jiǎn)單分享當(dāng)下較常用的評(píng)價(jià)標(biāo)準(zhǔn)，其中包括：編碼規(guī)范、可讀性、可維護(hù)性、重復(fù)度及可測(cè)試性。
編碼規(guī)范主要包含是否遵守了最佳實(shí)踐和團(tuán)隊(duì)編碼規(guī)范，是否包含可能出問(wèn)題的代碼，以及可能存在安全的漏洞。編碼規(guī)范有助于提高團(tuán)隊(duì)內(nèi)協(xié)助的效率以及代碼的可維護(hù)性。
可讀性Code Review 是一個(gè)很好的測(cè)驗(yàn)代碼可讀性的手段。如果你的同事可以輕松地讀懂你寫(xiě)的代碼，那說(shuō)明你的代碼可讀性很好；反之則說(shuō)明你的代碼可讀性有待提高了。遵守編碼規(guī)范也能讓我們寫(xiě)出可讀性更好的代碼。
可維護(hù)性代碼的可維護(hù)性是由很多因素協(xié)同作用的結(jié)果。代碼的可讀性好、簡(jiǎn)潔、可擴(kuò)展性好，就會(huì)使得代碼易維護(hù)；更細(xì)化地講，如果代碼分層清晰、模塊化好、高內(nèi)聚低耦合、遵從基于接口而非實(shí)現(xiàn)編程的設(shè)計(jì)原則等等，那就可能意味著代碼易維護(hù)。除此之外，代碼的易維護(hù)性還跟項(xiàng)目代碼量的多少、業(yè)務(wù)的復(fù)雜程度、利用到的技術(shù)的復(fù)雜程度、文檔是否全面等諸多因素有關(guān)。
重復(fù)度遵守 Don’t Repeat Yourself 原則，盡量減少重復(fù)代碼的編寫(xiě)，復(fù)用已有的代碼。對(duì)項(xiàng)目定期進(jìn)行代碼重復(fù)度檢測(cè)是一個(gè)很有意義的事，可以幫助開(kāi)發(fā)人員發(fā)現(xiàn)冗余代碼，進(jìn)行代碼抽象和重構(gòu)。重復(fù)的代碼一旦出錯(cuò)，意味著加倍的工作量和持續(xù)的不可控。如果代碼中有大量的重復(fù)代碼，就要考慮將重復(fù)的代碼提取出來(lái)，封裝成公共的方法或者組件。
可測(cè)試性代碼可測(cè)試性的好壞，同樣可以反應(yīng)代碼質(zhì)量的好壞。代碼的可測(cè)試性差，比較難寫(xiě)單元測(cè)試，那基本上就能說(shuō)明代碼設(shè)計(jì)得有問(wèn)題。
除此之外還有很多代碼質(zhì)量評(píng)價(jià)標(biāo)準(zhǔn)。我們需要一些取舍，選取部分大家有共識(shí)的規(guī)則定義團(tuán)隊(duì)好的代碼標(biāo)準(zhǔn)。
代碼質(zhì)量維度
當(dāng)前版本通過(guò) @iceworks/doctor 從 5 個(gè)維度對(duì)代碼進(jìn)行評(píng)分：
最佳實(shí)踐：?通過(guò) @iceworks/eslint-plugin-best-practices 分析項(xiàng)目，提出符合當(dāng)前工程特征（對(duì) ice 和 Rax項(xiàng)目友好）的最佳實(shí)踐及阻塞問(wèn)題發(fā)布卡口，幫助開(kāi)發(fā)者優(yōu)化項(xiàng)目性能，避免潛在 bug 。 安全實(shí)踐：?通過(guò) @iceworks/eslint-plugin-security-practices 掃碼代碼檢測(cè)工程中可能存在的安全風(fēng)險(xiǎn)，包含 url 、敏感成詞、明文賬密信息及 npm 包證書(shū)檢測(cè)，降低項(xiàng)目安全風(fēng)險(xiǎn)，守衛(wèi)項(xiàng)目安全。 阿里代碼規(guī)范：?這一維度主要反饋開(kāi)發(fā)人員對(duì)于 eslint-config-ali 阿里開(kāi)發(fā)規(guī)約的遵守程度。 可維護(hù)度：?通過(guò) typhonjs-escomplex 對(duì)文件進(jìn)行掃碼，得出每個(gè)文件的可維護(hù)度，可讀性及復(fù)雜度評(píng)分。針對(duì)得分較差的文件可以進(jìn)行深度分析幫助開(kāi)發(fā)者更好的重構(gòu)復(fù)雜代碼。 重復(fù)度：?通過(guò) jscpd 計(jì)算重復(fù)出現(xiàn)的代碼區(qū)塊占比，計(jì)算出 clone 分?jǐn)?shù)。并逐一列舉重復(fù)的代碼，方便開(kāi)發(fā)者快速定位重復(fù)代碼，將其封裝成公共的方法或者組件。
根據(jù)上述 5 個(gè)維度通過(guò)加權(quán)平均的方式計(jì)算項(xiàng)目質(zhì)量分，并根據(jù)木桶效應(yīng)，在計(jì)算得分的過(guò)程中加大了最低分的權(quán)重，得出最終項(xiàng)目質(zhì)量評(píng)分。
項(xiàng)目地址
github地址：https://github.com/ice-lab/iceworks/tree/master/
-?END - 推薦案例
溫暖提示
為了方便大家更好的學(xué)習(xí)，本公眾號(hào)經(jīng)常分享一些完整的單個(gè)功能案例代碼給大家去練習(xí)，如果本公眾號(hào)沒(méi)有你要學(xué)習(xí)的功能案例，你可以聯(lián)系小編（微信：xxf960513）提供你的小需求給我，我安排我們這邊的開(kāi)發(fā)團(tuán)隊(duì)免費(fèi)幫你完成你的案例。 注意：只能提單個(gè)功能的需求不能要求功能太多，比如要求用什么技術(shù)，有幾個(gè)頁(yè)面，頁(yè)面要求怎么樣？
請(qǐng)長(zhǎng)按識(shí)別二維碼
想學(xué)習(xí)更多的java功能案例請(qǐng)關(guān)注
Java項(xiàng)目開(kāi)發(fā)
如果你覺(jué)得這個(gè)案例以及我們的分享思路不錯(cuò)，對(duì)你有幫助，請(qǐng)分享給身邊更多需要學(xué)習(xí)的朋友。別忘了《留言+點(diǎn)在看》給作者一個(gè)鼓勵(lì)哦