在 Visual Studio 中自动重新设置 Python 代码的格式

借助 Visual Studio,可以快速重新格式化代码以匹配特定的格式化程序标准。 本文探讨如何访问和启用格式设置功能。

选择格式化程序

可以通过“工具”>“选项”>“文本编辑器”>“Python”>“格式设置”来设置源代码格式化程序。 Visual Studio 中的 Python 工具支持使用 autopep8、Black 格式化程序和 yapf 设置源代码格式。

Screenshot of the Python formatting options in Visual Studio and the Black formatter option selected.

借助 Visual Studio 中的 Python 支持,还可在“编辑”>“高级”菜单中添加“填充注释段落”命令,如后面的部分所述。

将格式应用于所选内容或文件

可以将格式设置应用于文件中的所有内容或仅应用于特定选择。

>>若要设置选定内容的格式,请依次选择“编辑”“高级”“设置选定内容的格式”。

>>若要设置整个文件的格式,请依次选择“编辑”“高级”“设置文档的格式”。

自动换行

可以在“工具”>“选项”>“文本编辑器”>“Python”>“常规”中启用自动换行。 在“设置”部分,选中“自动换行”复选框。

Screenshot that shows how to enable word wrapping for Python in Visual Studio.

设置注释文本格式

“编辑”>“高级”>“填充注释段落”选项可重排注释文本并设置其格式。

重格式化长行

使用该功能可以分解长文本行,如以下示例所示:

# This is a very long long long long long long long long long long long long long long long long long long long comment

文本被重格式化为多行:

# This is a very long long long long long long long long long long long long
# long long long long long long long comment

合并短行

使用此功能合并短文本行,如以下示例所示:

# Short line of text
# more text
# text

文本被重格式化为一行:

# Short line of text more text text