VS Code 中常用的 Python 代码格式化工具

VS Code 中的 Python 代码格式化方案

在 VS Code 里，保持 Python 代码整洁规范离不开合适的格式化工具。目前主流的选择主要有 Black、autopep8 和 yapf，它们各有侧重，下面对比一下核心特点：

工具名称	核心特点	风格理念	推荐适用场景
Black	开箱即用，几乎无需配置；强制统一的代码风格，可预测性强。	'无妥协'的格式化器。它决定格式，讨论空间小，保证所有代码风格一致。	团队协作项目；希望零配置快速上手的开发者；追求极简和一致性。
autopep8	基于 PEP 8 规范，主要修复代码风格问题（如缩进、空格）。	相对保守，专注于修复而非重新排版。	希望代码严格遵循 PEP 8；对现有代码进行温和的格式化修复。
yapf	高度可定制，可以模仿多种代码风格；格式化策略更'激进'，会重新排版代码。	'自成风格'。目标是通过调整代码来达到最佳可读性，而非严格遵循某一规范。	需要高度自定义格式化规则；项目有特殊的代码风格要求。

安装与配置

以使用最广泛的 Black 为例，其他工具流程类似。

1. 环境准备

先在 Python 环境中安装对应的库：

pip install black

2. 启用插件

打开 VS Code 扩展商店，搜索并安装 "Black Formatter"。官方 Python 扩展（ms-python.python）通常已内置支持，但显式安装插件能确保功能完整。

3. 设置默认格式化器

进入设置界面（Ctrl+,），搜索 default formatter，为 Python 语言选择 ms-python.black-formatter。同时勾选 Editor: Format On Save，这样每次保存文件时都会自动触发格式化。

进阶技巧

• 手动触发：除了自动保存，随时可用快捷键 Shift + Alt + F（Windows）或 Shift + Option + F（Mac）手动格式化当前文档。
• 调整行宽：Black 默认行宽是 88 字符，若需改为 100，可在设置中添加以下配置：

"python.formatting.blackArgs": ["--line-length", "100"]

• 避免冲突：如果同时安装了多个格式化工具或 Linter（如 flake8），可能会产生规则冲突。确定使用 Black 后，建议在设置中禁用其他工具：