sublime text 配置 autopep8 自动格式化需先安装 package control 和 autopep8 插件，确保系统已安装 autopep8 库并可通过终端调用，再在用户设置中启用 autoformat_on_save 并正确指定 python_bin 路径及文件包含规则。
Sublime Text 能用 AutoPEP8 自动格式化 Python 代码，但前提是 autopep8 命令在系统 PATH 中可用，且插件配置指向了正确的 Python 环境——这点最容易被跳过，导致“点了保存没反应”或“右键菜单灰掉”。
确认系统已安装 autopep8 可执行命令
插件本身不带格式化逻辑，它只是调用你系统里已安装的 autopep8 命令。如果终端里运行 autopep8 --version 报错（如 command not found），插件必然失效。
- 用
pip install autopep8安装（推荐在当前项目虚拟环境中装，避免全局污染） - 若使用 conda 环境，改用
conda install -c conda-forge autopep8 - 装完后务必在终端执行
autopep8 --version验证是否可调用；若提示找不到，说明 PATH 没包含该环境的Scripts（Windows）或bin（macOS/Linux）目录 - Sublime 启动方式会影响环境变量：直接双击图标启动时，可能读不到 shell 中配置的 PATH；建议从终端用
subl命令启动（需先配置subl命令），或在插件设置中显式指定python_bin
安装 AutoPEP8 插件并启用保存自动格式化
Package Control 是唯一可靠安装渠道，手动下载 ZIP 放 Packages 目录的方式在 ST4+ 已基本失效，且容易引发权限或路径问题。
- 按
Ctrl+Shift+P（macOS 为Cmd+Shift+P）打开命令面板 - 输入
Install Package回车，等待列表加载完成 - 搜索
AutoPEP8（注意大小写和空格，不是 “autopep8” 或 “Auto Pep 8”） - 选中安装，完成后重启 Sublime（部分版本需重启才加载）
- 打开
Preferences → Package Settings → AutoPEP8 → Settings，在右侧用户设置中加入：{ "autoformat_on_save": true, "max-line-length": 88, "include": ["*.py"], "exclude": ["*/migrations/*", "*/venv/*", "*/env/*"] }其中exclude强烈建议加上，否则 Django 迁移文件或虚拟环境里的脚本会被误格式化
插件不响应保存？检查 python_bin 和文件语法类型
即使 autopep8 命令能运行，Sublime 也可能因找不到 Python 解释器而静默失败——尤其当你有多个 Python 版本或使用 pyenv、conda 时。
- 在 AutoPEP8 用户设置中显式指定解释器路径，例如：
"python_bin": "/Users/you/.pyenv/versions/3.11.9/bin/python"
（macOS/Linux）或"python_bin": "C:\Users\you\AppData\Local\Programs\Python\Python311\python.exe"
（Windows） - 确保当前文件的语法类型是
Python：右下角状态栏应显示 “Python”，而不是 “Plain Text” 或 “Python 3”；若不对，点击切换，或通过View → Syntax → Python手动设置 - 插件默认只处理
.py文件，如果你编辑的是.pyi或.ipy，需在include中追加对应 glob 模式 - 保存时无反应但右键菜单正常？大概率是
autoformat_on_save没生效，检查设置文件是否拼写错误（比如写成auto_format_on_save）或被逗号/括号破坏了 JSON 结构
最常被忽略的点：Sublime 启动时没继承 shell 的 PATH，导致它根本找不到 autopep8；与其反复调试环境变量，不如在插件设置里直接填死 python_bin 和 autopep8 的绝对路径（用 which autopep8 或 where autopep8 查）。格式化本身很快，但路径错了，就永远卡在“看起来装好了，实际没跑”。
