在 VS Code 里写 Python,保持代码整洁离不开合适的格式化工具。市面上主流的选择主要有三款,特性对比如下:
| 工具名称 | 核心特点 | 风格理念 | 推荐适用场景 |
|---|---|---|---|
| Black | 开箱即用,几乎无需配置;强制统一的代码风格,可预测性强。 | '无妥协'的格式化器。它决定格式,讨论空间小,保证所有代码风格一致。 | 团队协作项目;希望零配置快速上手的开发者;追求极简和一致性。 |
| autopep8 | 基于 PEP 8 规范,主要修复代码风格问题(如缩进、空格)。 | 相对保守,专注于修复而非重新排版。 | 希望代码严格遵循 PEP 8;对现有代码进行温和的格式化修复。 |
| yapf | 高度可定制,可以模仿多种代码风格;格式化策略更'激进',会重新排版代码。 | '自成风格'。目标是通过调整代码来达到最佳可读性,而非严格遵循某一规范。 | 需要高度自定义格式化规则;项目有特殊的代码风格要求。 |
选好了工具,接下来就是在 VS Code 里落地。咱们以使用最广泛的 Black 为例,其他工具的流程大同小异。
第一步是确保环境里有工具。别只装插件,底层依赖也得跟上:
pip install black
然后去扩展商店搜索并安装 'Black Formatter' 插件。官方 Python 扩展(ms-python.python)也内置了对这些格式化器的支持,记得确认一下是否已启用。
配置环节最关键的是两个开关。打开设置 (Ctrl+,),先搜 format on save,勾选 Editor: Format On Save。这样每次保存文件时都会自动触发格式化,不用手动点。
接着设置默认格式化器。在设置里搜 default formatter,为 Python 语言指定默认选项,下拉列表里选 ms-python.black-formatter。搞定这些,保存文件就能自动变整齐了。
有些进阶技巧可能用得上。比如快捷键,除了自动保存,随时按 Shift + Alt + F(Windows)或 Shift + Option + F(Mac)也能手动格式化当前文档。
如果默认的行宽不符合你的习惯,Black 默认是 88 字符,可以在 VS Code 设置里改。比如在 settings.json 里加一行:
"python.formatting.blackArgs": ["--line-length", "100"]
这就把行宽调到了 100。
另外,如果你同时装了多个格式化工具或 Linter(比如 flake8),可能会打架。确定用 Black 的话,最好在设置里禁用其他的,避免规则冲突:
"python.formatting.autopep8Enabled":

