只用VSCode自帶的Format功能,即可滿足可配置的代碼格式化需求!下面本篇文章就來帶大家了解一下VSCode的Format功能,希望對大家有所幫助!
近年開發(fā)環(huán)境越來越重視代碼的規(guī)范化,借助工具來檢查、自動化修復(fù),成為了代碼保障的第一選擇。
一般會使用Lint (ESLint StyleLint)或Prettier等輔助工具,通過簡單的配置部署,就可以使用一些比較流行的Code Style規(guī)范,達到自動提示、自動修復(fù)、自動執(zhí)行和監(jiān)督的目的。
(資料圖)
但是不知道大家有沒有遇到以下幾種情景:
IDE里敲代碼時,由于沒有實時format(一般在save時自動format),總是出現(xiàn)紅色的提示,總是以為是自己的語法寫錯了,其實只是還未format。(比如ESLint插件的自動校驗提示)
剛開始使用時,總是遇到不理解的規(guī)則(可能太過嚴格了),還得點進到提示里查看具體原因,相當于一邊開發(fā)一邊學(xué)習(xí)規(guī)則。
寫了一段代碼,save后代碼突然變長了,全給換行了,50行的code硬生生給拉到100行。這里就不指名誰了。
對代碼規(guī)范(更多的指格式化)并沒有太多要求,比如項目比較小,項目進度比較緊等。只要能滿足基本的格式化要求就行。
尤其是最后一條,其實很多小項目只要能滿足最基本的格式化就行,能保證團隊內(nèi)都能滿足并執(zhí)行一套簡單規(guī)范,其它比較嚴格的規(guī)范可以不用考慮。
這里提到一個概念,規(guī)范分為兩種:代碼格式規(guī)則(Formatting rules)和 代碼質(zhì)量規(guī)則(Code-quality rules)。上述提到的基本規(guī)范,基本就屬于代碼格式規(guī)則。
下面列下有哪些常用的,基本的格式化規(guī)則,即代碼格式規(guī)則,以 standardjs style 為例:
分號。eslint: semi
空格縮進。eslint: indent
關(guān)鍵字后面加空格。eslint: keyword-spacing
函數(shù)聲明時括號與函數(shù)名間加空格。eslint: space-before-function-paren
字符串拼接操作符之間要留空格。eslint: space-infix-ops
逗號后面加空格。eslint: comma-spacing
單行代碼塊兩邊加空格。eslint: block-spacing
文件末尾留一空行。eslint: eol-last
鍵值對當中冒號與值之間要留空白。eslint: key-spacing
除了縮進,不要使用多個空格。eslint: no-multi-spaces
行末不留空格。eslint: no-trailing-spaces
屬性前面不要加空格。eslint: no-whitespace-before-property
遇到分號時空格要后留前不留。eslint: semi-spacing
代碼塊首尾留空格。eslint: space-before-blocks
圓括號間不留空格。eslint: space-in-parens
模板字符串中變量前后不加空格。eslint: template-curly-spacing
可以看到,基本都是分號縮進空格空白相關(guān)的規(guī)范,而這些規(guī)范在一些IDE里已經(jīng)集成好了。
比如VSCode,就可以通過簡單配置,滿足上述的所有規(guī)則。
VSCode自身就帶有一個Format功能,大多文件類型都支持。默認快捷鍵是Ctrl+K+D。
還支持設(shè)置為Format on Save。
然后列下上述基本規(guī)范里,哪些不包含在默認Format功能里。
分號。- 默認沒有規(guī)范,可以通過settings配置。
空格縮進。- 默認4個空格TabSize,可以通過settings配置。
函數(shù)聲明時括號與函數(shù)名間加空格。- 跟standardjs不一樣,VSCode默認沒有空格。
文件末尾留一空行。- 默認沒有,可以通過settings配置。
就4個,其中第3個可以說規(guī)則不一樣,但是有規(guī)則的,所以綜合就3個。所以說大部分規(guī)則默認format功能里已經(jīng)支持了。
分為三種規(guī)范:要求必須有分號;禁止分號;都行。市面上流行規(guī)范里,啥樣都有,但是一般都是要求必須有或者禁止的。
VSCode默認沒有要求,但是可以通過settings定義:
ignore默認,就是有沒有分號都行;
insert必須有分號;
remove禁止分號。
一般分為兩種規(guī)范,2個空格還是4個空格,現(xiàn)在大多市面上流行的規(guī)范里,都是以2個空格為準。
VSCode默認規(guī)范是:
Detect Indentation對應(yīng)settings: editor.detectIndentation默認值true,根據(jù)當前文件內(nèi)容來檢測當前文件是2個空格還是4個空格,然后根據(jù)這個來Format;Tab Size對應(yīng)settings: editor.tabSize:默認值4,如果是新建文件,則是根據(jù)這個值來確定,默認是4個tab size。如上圖是默認配置,如果想所有文件都以2個空格縮進作為規(guī)范,可以先關(guān)掉Detect Indentation,再把Tab Size設(shè)置為2。
如果不關(guān)Detect Indentation,只改Tab Size為2,則是根據(jù)文件內(nèi)容縮進,然后新建文件是2個空格縮進。
VSCode是根據(jù)什么檢測文件的tabsize是多大,可以在文件底部狀態(tài)欄看到,點擊還可以更改。
settings里搜索關(guān)鍵字insertFinalNewline,默認選項是disable的,check上,save時就會給所有文件末尾留一空行。
綜上,所有settings配置如下:
這里建議設(shè)置Workspace下的settings,設(shè)置后會在.vscode路徑下生成settings.json文件,可以提交到git上統(tǒng)一開發(fā)團隊內(nèi)部規(guī)范。
// .vscode/settings.json{ "editor.formatOnSave": true, // 保存文件自動format "javascript.format.semicolons": "insert", // js文件,強制必須有分號,設(shè)置`remove`則禁止分號 "typescript.format.semicolons": "insert", // ts文件,同上 "editor.tabSize": 2, // 設(shè)置默認縮進為2個空格 "editor.detectIndentation": false, // 是否強制所有文件按tabSize設(shè)置縮進;"否"則根據(jù)文件內(nèi)容縮進、新建文件按tabSize縮進。 "files.insertFinalNewline": true, // 所有文件末尾留一空行 "[javascript]": { "editor.defaultFormatter": "vscode.typescript-language-features" // 設(shè)置js類型文件的默認format為VSCode自帶Format }, "[javascriptreact]": { "editor.defaultFormatter": "vscode.typescript-language-features" // jsx文件,同上 }, "[css]": { "editor.defaultFormatter": "vscode.css-language-features" // css文件,同上 }, "[less]": { "editor.defaultFormatter": "vscode.css-language-features" // less文件,同上 }}其實VSCode settings里還可以配置更多的format配置,大家可以自己摸索。
比如css、less、json、md等,個人感覺直接用VSCode默認的就夠了。
除了以上提到的代碼格式規(guī)則,其它規(guī)范就屬于是代碼質(zhì)量規(guī)則了,這種用ESLint規(guī)范下就行了,因為這些規(guī)范和上述代碼格式規(guī)則是不沖突的,配合ESLint的auto fix on save,可以滿足保存文件的時候,先用VSCode format 代碼格式規(guī)則,然后用ESLint處理代碼質(zhì)量規(guī)則。舉幾個例子:
強制單引號或雙引號。eslint: quotes
始終使用。 ===替代 ==。eslint: eqeqeq
關(guān)于ESLint的用法,可以參考之前的文章:ESLint配合VSCode 統(tǒng)一團隊前端代碼規(guī)范
本文整理了如何只用VSCode開發(fā)工具,來規(guī)范前端Code的代碼格式規(guī)范,并且支持可配置、保存文件自動格式化代碼功能。
優(yōu)點:
配置簡單,不用安裝各種npm或者插件,VSCode自身就有的功能。
適合小的簡單項目,或者對代碼格式規(guī)范需求不高的項目,適合小廠。
部分規(guī)則支持自定義,可按實際需求進行配置。
缺點:
規(guī)則不多,基本都是代碼格式規(guī)則,做不了代碼質(zhì)量規(guī)則的校驗,需要結(jié)合ESLint搭配。
滿足不了對格式規(guī)范要求比較高的項目,比如大項目、大廠。
相比ESLint,規(guī)則很少,可配置化也不多。
相比Prettier,規(guī)則也很少,肯定比不了一些流行的代碼風(fēng)格規(guī)范。
沒辦法通過Git Hooks做到提交代碼時的自動校驗。
此文只是提供了一種代碼格式規(guī)范的一種解決方案,一種思路,適不適合自己還得看自身需求。
更多關(guān)于VSCode的相關(guān)知識,請訪問:vscode基礎(chǔ)教程!
以上就是帶你用VSCode的Format功能實現(xiàn)代碼格式化的詳細內(nèi)容,更多請關(guān)注php中文網(wǎng)其它相關(guān)文章!
關(guān)鍵詞: