VSCode默认不识别autopep8，必须同时满足环境安装、解释器绑定和格式化器显式指定三条件：先在当前Python解释器环境安装autopep8，再于settings.json中配置"python.formatting.provider":"autopep8"及--in-place等参数，并启用editor.formatOnSave。
VSCode 默认不识别 autopep8，装了也不生效——必须同时满足「环境安装 + 解释器绑定 + 格式化器显式指定」三个条件，缺一不可。
确认 autopep8 已安装在当前 Python 解释器环境中
VSCode 不关心系统全局或其它虚拟环境里有没有 autopep8，只认它当前激活的 Python 解释器路径下的可执行命令。
- 打开 VSCode 内置终端（
Ctrl+`），先确认解释器：运行python -c "import sys; print(sys.executable)"，看路径是否是你预期的环境（比如venv/bin/python或poetry env info --path对应的路径） - 在同一终端中直接运行
autopep8 --version；如果报command not found或'autopep8' is not recognized，说明没装对环境 - 正确安装方式是：先激活目标环境（如
source venv/bin/activate或poetry shell），再运行pip install autopep8；conda 用户用conda install -c conda-forge autopep8
在 settings.json 中显式启用 autopep8 为 Python 格式化器
VSCode 的 python.formatting.provider 设置项是语言级配置，不是全局设置，也不能靠插件自动启用。
- 打开设置（
Ctrl+,），搜索python formatting provider，下拉选autopep8；或者直接编辑settings.json - 必须添加这两行（注意：不是
editor.defaultFormatter，那是旧版或通用设置，对 Python 无效）：
"python.formatting.provider": "autopep8", "python.formatting.autopep8Args": ["--in-place", "--aggressive", "--max-line-length=100"]
-
--in-place是关键：不加它，autopep8默认只输出修改后代码到控制台，不改文件 -
--aggressive可重复使用（如两次），但第二次会更激进（比如删空行、拆嵌套括号），团队协作建议只用一次 - 如果项目有
setup.cfg或pyproject.toml，autopep8会优先读取其中的[pep8]或[tool.autopep8]配置，autopep8Args仅作补充
检查 Python 插件与格式化触发时机
即使配置全对，也可能因插件状态或保存行为导致“看起来没反应”。
- 确保已安装官方
ms-python.python插件（非ms-python.autopep8—— 这个扩展早已弃用且不兼容新版本） - 启用自动保存格式化：
editor.formatOnSave必须为true；若只想对 Python 文件生效，可写成"[python]": {"editor.formatOnSave": true} - 手动触发时用
Shift+Alt+F（Windows/Linux）或Shift+Option+F（macOS），不是右键菜单里的“格式化文档”（该选项依赖当前语言模式和 formatter 是否就绪） - 如果仍提示
command 'autopep8' not found，尝试显式配置路径：python.formatting.autopep8Path设为which autopep8输出的绝对路径（Linux/macOS）或where autopep8（Windows）
最容易被忽略的是解释器切换后未重装 autopep8，以及误以为装过一次就能跨环境使用。每次换解释器（包括新建 venv、切换 Poetry 环境、conda activate 新环境），都得重新 pip install 一遍，并在 VSCode 里重新确认 Python: Select Interpreter 选中它。
