Black的背景

Black的起源和發(fā)展歷程

Black是由意大利程序員賈庫倫·瑞科（?ukasz Langa）于2018年創(chuàng)建的一款開源Python代碼格式化工具。他的初衷是通過強制一致的代碼風(fēng)格來提高代碼的可讀性，減少開發(fā)者之間關(guān)于代碼格式的爭論，從而使團隊更容易協(xié)作。

在起初的幾個版本中，Black受到了一些爭議，因為它采用了一種非常嚴格的風(fēng)格，例如使用單引號而不是雙引號，以及強制行長限制等。然而，隨著時間的推移，Black在社區(qū)中逐漸獲得了認可，因為它的設(shè)計哲學(xué)更加注重一致性和簡潔。

Black的基本格式化效果

一個簡單的Python函數(shù)示例演示Black的基本格式化效果：

# 未格式化的代碼
def   add (  x, y ) :
    return  x+y

運行Black進行格式化：

black example.py

格式化后的代碼：

# 格式化后的代碼
def add(x, y):
    return x + y

從這個簡單的例子中可以看到，Black會自動調(diào)整縮進、添加適當(dāng)?shù)目崭瘢勾a更加一致和易讀。

安裝與配置

1. 安裝Black

首先，需要使用pip安裝Black。在終端或命令提示符中執(zhí)行以下命令：

pip install black

這將會安裝最新版本的Black。

2. 創(chuàng)建配置文件

為了定制Black的行為，可以創(chuàng)建一個名為pyproject.toml的配置文件。在項目根目錄下執(zhí)行以下命令：

touch pyproject.toml

3. 基本配置選項

在pyproject.toml中，可以配置Black的一些基本選項，例如行寬度（line-length）和目標Python版本（target-version）。

# pyproject.toml
[tool.black]
line-length = 88
target-version = ['py38']

在這個示例中，將行寬度設(shè)置為88個字符，并指定目標Python版本為3.8?？梢愿鶕?jù)項目需求進行相應(yīng)的調(diào)整。

4. 更多配置選項

除了基本選項之外，Black還提供了許多其他配置選項，以滿足不同項目的需求。以下是一些示例：

exclude： 用于指定要忽略的文件或目錄。例如：

# pyproject.toml
[tool.black]
exclude = '''
/tests/
/docs/
'''

skip-string-normalization： 如果不希望對字符串進行規(guī)范化，可以使用此選項。例如：

# pyproject.toml
[tool.black]
skip-string-normalization = true

use-tabs： 如果項目使用制表符而不是空格，請啟用此選項。例如：

# pyproject.toml
[tool.black]
use-tabs = true

5. 運行Black

配置完成后，可以在終端中運行Black，以格式化項目中的所有符合條件的Python文件。

black .

以上示例展示了如何安裝Black并配置一些基本選項。通過在pyproject.toml文件中添加適當(dāng)?shù)呐渲茫梢愿鶕?jù)項目的需求定制Black的行為。

基本用法

Black的基本用法非常簡單，只需在終端或命令行中運行Black，并指定要格式化的目標文件或目錄。

1. 安裝Black

首先，確保已經(jīng)安裝了Black。如果沒有安裝，可以使用以下命令進行安裝：

pip install black

2. 運行Black

在終端中，進入項目目錄，并運行以下命令：

black .

這個命令將會格式化當(dāng)前目錄下的所有符合條件的Python文件。也可以指定具體的文件或目錄，例如：

black my_file.py my_directory/

3. 自動遞歸

默認情況下，Black會遞歸地格式化目錄下的所有文件。如果想要顯示哪些文件被格式化了，可以加上--check選項，Black將只檢查格式而不進行實際的修改。

black --check .

4. 檢查格式差異

如果想查看格式化前后的具體差異，可以使用--diff選項：

black --diff .

這個選項會顯示格式化前后的差異，但并不會實際修改文件。

5. 在編輯器中使用

許多代碼編輯器都支持Black的集成，使得在編輯器中直接應(yīng)用格式化變得更加方便。例如，在VSCode中，可以安裝插件并配置以在保存文件時自動運行Black。

Black的特性

Black作為一款強大的Python代碼格式化工具，不僅提供了基本的格式化功能，還支持一些高級特性，使其更加靈活和適應(yīng)不同的項目需求。

1. 忽略文件和目錄

Black允許你通過配置文件來指定要忽略的文件或目錄，以便在格式化時排除特定的部分。在pyproject.toml中使用exclude選項：

# pyproject.toml
[tool.black]
exclude = '''
/tests/
/docs/
'''

在這個例子中，Black將忽略項目中的/tests/和/docs/目錄下的文件。

2. 自定義行寬和縮進

通過配置文件，你可以輕松地調(diào)整Black的一些格式化設(shè)置，如行寬度和縮進。例如，將行寬度設(shè)置為120，使用制表符而不是空格：

# pyproject.toml
[tool.black]
line-length = 120
use-tabs = true

這個配置將使Black在格式化時將行寬度限制為120個字符，并使用制表符進行縮進。

3. 編輯器集成

Black與許多流行的代碼編輯器集成得很好。在許多編輯器中，你可以通過配置使Black在保存文件時自動運行。以VSCode為例，在settings.json文件中添加以下配置：

// settings.json
"editor.formatOnSave": true,
"python.formatting.provider": "black"

這樣配置后，每次保存Python文件時，Black都會自動格式化代碼。

4. 額外的命令行選項

除了配置文件之外，Black還提供了一些命令行選項，允許你在運行時覆蓋特定的設(shè)置。例如，你可以使用--check選項來檢查代碼是否符合Black的格式，而不進行實際的格式化。

black --check .

5. 在版本控制中使用

Black的格式化輸出通常會修改文件，因此在版本控制中使用時需要小心。你可以使用--diff選項來查看格式化前后的差異，而不實際修改文件：

black --diff .

這能夠在提交代碼之前檢查潛在的更改。

通過深入了解Black的高級特性，你可以更好地定制工具以適應(yīng)你的項目需求。這些特性使Black成為一個強大而靈活的代碼格式化工具，適用于各種Python項目。

Black與其他格式化工具的比較

Black、YAPF和autopep8都是Python代碼格式化工具，它們各自有著獨特的設(shè)計理念和特點。以下是它們之間的一些比較：

1. 設(shè)計理念

Black： Black的設(shè)計理念強調(diào)一致性和簡潔。它采用了一種“不容商量”的方式，通過強制一種固定的代碼風(fēng)格來減少開發(fā)者之間的爭論，確保整個項目的代碼具有一致性。

YAPF： YAPF（Yet Another Python Formatter）也注重一致性，但相對于Black，它提供了更多的配置選項，允許用戶根據(jù)自己的偏好調(diào)整格式化的細節(jié)。

autopep8： autopep8的目標是自動修復(fù)PEP 8規(guī)范中的問題。它側(cè)重于通過調(diào)整空格、縮進等方式來使代碼符合PEP 8標準，但并不強制一種特定的風(fēng)格。

2. 配置選項

Black： Black的配置選項相對較少。它更傾向于采用一組默認的風(fēng)格規(guī)則，以簡化配置，并鼓勵項目中所有的代碼都采用相同的風(fēng)格。

YAPF： YAPF提供了大量的配置選項，使用戶可以精細調(diào)整格式化的行為。這使得YAPF更加適用于那些需要高度定制的項目。

autopep8： autopep8也提供了一些配置選項，允許用戶在一定程度上調(diào)整格式化規(guī)則，但相較于YAPF，它的配置相對簡單。

3. 自動化程度

Black： Black的自動化程度非常高。它幾乎沒有人為干預(yù)的余地，通過運行一次命令即可完成整個項目的代碼格式化。

YAPF： YAPF在自動化程度上也很高，但相對于Black，它提供了更多的配置選項，使用戶可以更靈活地調(diào)整代碼風(fēng)格。

autopep8： autopep8的自動化程度較高，但用戶在使用時仍有一定的控制權(quán)，可以選擇性地應(yīng)用或忽略某些修復(fù)。

4. 速度

Black： Black在速度上通常較快，尤其是對于大型項目。它通過強制一致的規(guī)則來提高處理速度。

YAPF： YAPF的速度也較快，但由于提供了更多的配置選項，可能在處理復(fù)雜格式時稍顯耗時。

autopep8： autopep8通常也能夠快速處理格式化，但在處理復(fù)雜代碼時可能略顯緩慢。

5. 社區(qū)支持與活躍度

Black： Black在Python社區(qū)中逐漸獲得了廣泛的認可，得到了許多項目的采用，并且其開發(fā)仍然非?；钴S。

YAPF： YAPF同樣受到了較多項目的青睞，具有一定的社區(qū)支持和活躍度。

autopep8： autopep8作為一個解決PEP 8規(guī)范的工具，也得到了廣泛的應(yīng)用，但在一些新項目中可能受到Black和YAPF的競爭。

總結(jié)

Black作為一款Python代碼格式化工具，在項目中有其獨特的優(yōu)勢。其設(shè)計理念注重一致性和簡潔，通過強制一種規(guī)范的代碼風(fēng)格，減少了開發(fā)者間的爭議，提高了整體代碼的可讀性。Black的自動化程度極高，簡單的命令即可完成整個項目的代碼格式化，使得團隊能夠更輕松地維持一致的代碼規(guī)范。

相較于其他格式化工具如YAPF和autopep8，Black在速度上表現(xiàn)出色，特別適合處理大型項目。盡管配置選項相對較少，但這也有助于項目內(nèi)部的一致性。Black在Python社區(qū)中得到廣泛認可，越來越多的項目采用它作為首選格式化工具。然而，對于一些需要更多定制選項的項目，YAPF和autopep8可能更為適用。

在選擇格式化工具時，團隊?wèi)?yīng)權(quán)衡工具的自動化程度、靈活性以及與項目需求的契合度。Black的簡潔和高效使其成為許多團隊的選擇，為項目提供了一致的、易讀的代碼風(fēng)格。

以上就是Python Black代碼格式化終極指南的詳細內(nèi)容，更多關(guān)于Python Black代碼格式化的資料請關(guān)注腳本之家其它相關(guān)文章！

最新評論