前面的話
在團隊開發中,統一的代碼格式是必要的。但是不同開發人員的代碼風格不同,代碼編輯工具的默認格式也不相同,這樣就造成代碼的differ。而editorConfig可以幫助開發人員在不同的編輯器和IDE中定義和維護一致的編碼風格。本文將詳細介紹統一代碼風格工具editorConfig
概述
editorConfig不是什么軟件,而是一個名稱為.editorconfig的自定義文件。該文件用來定義項目的編碼規范,編輯器的行為會與.editorconfig 文件中定義的一致,并且其優先級比編輯器自身的設置要高,這在多人合作開發項目時十分有用而且必要
有些編輯器默認支持editorConfig,如webstorm;而有些編輯器則需要安裝editorConfig插件,如ATOM、Sublime、VS Code等
當打開一個文件時,EditorConfig插件會在打開文件的目錄和其每一級父目錄查找.editorconfig文件,直到有一個配置文件root=true
EditorConfig的配置文件是從上往下讀取的并且最近的EditorConfig配置文件會被最先讀取. 匹配EditorConfig配置文件中的配置項會按照讀取順序被應用, 所以最近的配置文件中的配置項擁有優先權
如果.editorconfig文件沒有進行某些配置,則使用編輯器默認的設置
文件語法
editorConfig配置文件需要是UTF-8字符集編碼的, 以回車換行或換行作為一行的分隔符
斜線(/)被用作為一個路徑分隔符,井號(#)或分號(;)被用作于注釋. 注釋需要與注釋符號寫在同一行
【通配符】
* 匹配除/之外的任意字符串 ** 匹配任意字符串 ? 匹配任意單個字符 [name] 匹配name中的任意一個單一字符 [!name] 匹配不存在name中的任意一個單一字符 {s1,s2,s3} 匹配給定的字符串中的任意一個(用逗號分隔) {num1..num2} 匹配num1到num2之間的任意一個整數, 這里的num1和num2可以為正整數也可以為負整數
【屬性】
所有的屬性和值都是忽略大小寫的. 解析時它們都是小寫的
indent_style 設置縮進風格(tab是硬縮進,space為軟縮進)
indent_size 用一個整數定義的列數來設置縮進的寬度,如果indent_style為tab,則此屬性默認為tab_width
tab_width 用一個整數來設置tab縮進的列數。默認是indent_size
end_of_line 設置換行符,值為lf、cr和crlf
charset 設置編碼,值為latin1、utf-8、utf-8-bom、utf-16be和utf-16le,不建議使用utf-8-bom
trim_trailing_whitespace 設為true表示會去除換行行首的任意空白字符。
insert_final_newline 設為true表示使文件以一個空白行結尾
root 表示是最頂層的配置文件,發現設為true時,才會停止查找.editorconfig文件
實例
下面的實例中使用 4 個空格來縮進,并不是說按一下空格會自動打出 4 個空格來,也不是說要連按 4 下空格;而是按 tab 鍵時,編輯器會自動輸出 4 個空格的寬度,而不是之前默認的制表符 (\t)
# editorconfig.org
root = true
[*]
charset = utf-8
indent_size = 4
indent_style = space
insert_final_newline = true
trim_trailing_whitespace = true
[*.md]
trim_trailing_whitespace = false
文章列表