在 VS Code 中格式化 Python

格式化使得源代码更容易被人类阅读。通过强制执行特定的规则和约定，如行间距、缩进和运算符周围的间距，代码变得更具视觉组织性且更易理解。你可以在 autopep8 页面上查看示例。请记住，格式化本身不会影响代码的功能。

代码检查通过分析代码是否存在常见的语法、样式和功能错误以及非规范的编程实践来帮助预防错误。尽管格式化和代码检查之间存在一些重叠，但这两种功能是互补的。

选择格式化程序

在 VS Code 市场中搜索你选择的格式化程序扩展。

Microsoft 发布了以下格式化程序扩展

社区提供的格式化程序扩展

此外，以下是支持导入排序的格式化程序扩展

注意：如果你在上面的表格或市场中找不到你偏好的格式化程序，你可以通过扩展添加对其支持。你可以使用 Python 扩展模板将新的 Python 工具集成到 VS Code 中。

设置默认格式化程序

安装格式化程序扩展后，你可以按照以下步骤将其设置为 VS Code 中 Python 文件的默认格式化程序

1. 在 VS Code 中打开一个 Python 文件。
2. 右键单击编辑器以显示上下文菜单。
3. 选择 使用以下方式格式化文档...。
4. 从下拉菜单中选择 配置默认格式化程序...。
5. 从列表中选择你偏好的格式化程序扩展。

或者，你可以在用户 settings.json 文件中的 [python] 范围内设置 "editor.defaultFormatter"，以将其设置为所有 Python 文件的默认格式化程序。你可以使用 首选项: 打开用户设置 (JSON) 命令打开 settings.json。

例如，要将 Black 格式化程序设置为默认格式化程序，请将以下设置添加到你的用户 settings.json 文件中

  "[python]": {
    "editor.defaultFormatter": "ms-python.black-formatter"
  }

为了将格式化程序扩展设置为导入排序器，你可以在你的用户 settings.json 文件或工作区 settings.json 文件中的 [python] 范围内设置 "editor.codeActionsOnSave"。你可以分别使用 首选项: 打开用户设置 (JSON) 和 首选项: 打开工作区设置 (JSON) 命令打开这些 settings.json 文件。这将为所有 Python 文件启用保存时导入排序。

例如，要将 Ruff 设置为你偏好的导入排序器，可以将以下设置添加到你的用户 settings.json 或工作区 settings.json 文件中

{
  "[python]": {
    "editor.codeActionsOnSave": {
      "source.organizeImports.ruff": "explicit"
    }
  }
}

格式化代码

你可以通过右键单击编辑器并选择 格式化文档，或使用键盘快捷方式 ⇧⌥F (Windows Shift+Alt+F, Linux Ctrl+Shift+I) 来格式化你的代码。

你还可以在用户 settings.json 文件中添加以下设置，以启用代码保存时格式化

  "[python]": {
    "editor.formatOnSave": true
  }

通用格式化设置

你可以查阅每个格式化程序扩展的 README 文件，了解更多关于支持的设置的详细信息。大多数格式化程序扩展支持以下设置

格式化疑难解答

如果格式化失败，请检查以下可能的原因

注意：如果你在上面找不到你偏好的格式化程序，可以通过扩展添加支持。使用 Python 扩展模板可以轻松地将新的 Python 工具集成到 VS Code 中。

下一步

• 调试 - 了解如何在本地和远程调试 Python。
• 测试 - 配置测试环境，发现、运行和调试测试。
• 基本编辑 - 了解强大的 VS Code 编辑器。
• 代码导航 - 快速浏览你的源代码。
• Python 扩展模板 - 创建一个扩展，将你喜爱的代码检查工具集成到 VS Code 中。