文章出處

前面的話

  在團隊開發中,統一的代碼格式是必要的。但是不同開發人員的代碼風格不同,代碼編輯工具的默認格式也不相同,這樣就造成代碼的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

 


文章列表


不含病毒。www.avast.com
arrow
arrow
    全站熱搜
    創作者介紹
    創作者 大師兄 的頭像
    大師兄

    IT工程師數位筆記本

    大師兄 發表在 痞客邦 留言(0) 人氣()