### 如何在 VSCode 中安装 Python 代码格式化工具 要在 Visual Studio Code (VSCode) 中设置并使用 Python 的代码格式化工具，可以按照以下方法操作： #### 安装扩展 通过官方市场提供的扩展程序来支持 Python 开发环境。推荐使用的扩展名为 **Python**，由 Microsoft 提供[^1]。 ```plaintext 前往 VSCode 扩展视图（快捷键 Ctrl+Shift+X），搜索 “Python”，选择由 Microsoft 发布的扩展并点击安装按钮。 ``` #### 配置格式化工具 为了实现自动化的代码格式化功能，需配置合适的格式化器。常用的 Python 格式化工具有 `black` 和 `autopep8` 等[^2]。 ##### 使用 Black Black 是一种非常流行的 Python 自动格式化工件，它遵循严格的风格指南 PEP 8 并强制执行一致性的编码标准。 - 首先，在本地环境中安装 black 工具： ```bash pip install black ``` - 接着，在 VSCode 设置中启用 black 作为默认格式化工具。可以通过打开命令面板 (`Ctrl+Shift+P`) 输入 "Preferences: Open Settings (JSON)" 来编辑 settings.json 文件，并加入如下内容： ```json { "[python]": { "editor.formatOnSave": true, "editor.defaultFormatter": "ms-python.python" }, "python.formatting.provider": "black", "python.formatting.blackPath": "black", // 如果 black 不在 PATH 下，则指定完整路径 "python.formatting.blackArgs": ["--line-length=88"] // 可选参数调整行为 } ``` ##### 使用 Autopep8 Autopep8 同样是一个基于 PEP 8 准则工作的自动化修复工具，允许更灵活的选择性应用更改。 - 类似于 black，也需要预先安装 autopep8 到开发环境中： ```bash pip install autopep8 ``` - 修改 VSCode 用户或工作区级别的 setting JSON 添加相应条目以激活此选项： ```json { "[python]": { "editor.formatOnSave": true, "editor.defaultFormatter": "ms-python.python" }, "python.formatting.provider": "autopep8", "python.formatting.autopep8Args": [ "--max-line-length=79", "--aggressive", "--in-place" ] } ``` 完成以上步骤之后，当保存文件时会触发内置机制调用所选定的格式化插件处理当前文档中的语法结构[^3]。 #### 测试效果 创建一个新的 .py 文件或者修改现有的脚本项目源码尝试手动运行格式化命令验证其有效性(`Shift+Alt+F`)；如果一切正常的话应该能够看到即时修正后的版本呈现出来。 ---