autopep8插件装完没反应，主因是插件未启用、缺少系统级autopep8命令或缩进/编码设置不匹配；需验证是否出现在package control列表、安装python包autopep8并确保path可达、统一utf-8编码与空格缩进。
AutoPEP8插件装完却没反应？检查是否启用成功
装完 AutoPEP8 后右键菜单没有“AutoPEP8”选项，大概率是插件没真正启用。Sublime Text 的 Package Control 安装后不会自动激活插件，需手动确认状态。
- 按
Ctrl+Shift+P（Windows/Linux）或Cmd+Shift+P（macOS），输入Package Control: List Packages，看列表里是否有AutoPEP8 - 若存在但不生效，尝试重启 Sublime Text；若不存在，说明安装失败，重试
Package Control: Install Package→ 搜AutoPEP8 - 注意：该插件依赖系统级的
autopep8命令行工具，仅装插件不装 Python 包会报错autopep8 not found
格式化前必须装好 autopep8 Python 包
Sublime 插件只是调用命令行工具的外壳，底层靠你本地 Python 环境里的 autopep8 可执行文件。没它，插件根本跑不动。
- 在终端运行
pip install autopep8（推荐用项目虚拟环境的 pip，避免全局污染） - 如果用 conda，运行
conda install -c conda-forge autopep8 - 验证是否可用：
autopep8 --version能输出版本号才算成功 - 插件默认调用的是系统 PATH 中的
autopep8，如果你的 Python 环境不在 PATH 里（比如用 pyenv 或特定 venv），需在插件设置里指定完整路径，例如："autopep8_command": "/path/to/venv/bin/autopep8"
右键格式化 vs 快捷键触发，行为有差异
右键菜单选 “AutoPEP8” 和快捷键 Ctrl+Alt+8（Windows/Linux）或 Cmd+Alt+8（macOS）看起来一样，但实际作用范围不同。
- 右键菜单默认只格式化当前光标所在函数或类（如果选中了代码块，则只格式化选中部分）
- 快捷键默认格式化整个文件 —— 这才是多数人想要的行为
- 想让右键也全文件格式化？改插件用户配置：
"aggressive": 1+"in_place": true不够，关键是设"apply_to": "all" - 注意：
aggressive级别越高，改动越激进（比如把单行 if 展开、强制拆分长表达式），默认1已足够，设成2或3容易破坏原有可读结构
格式化后缩进异常或中文注释错位？检查编码和 tab 设置
autopep8 默认按 PEP 8 处理空格缩进，但它不处理文件编码声明或混合 tab/spaces 场景，容易导致中文注释偏移、缩进混乱。
- 确保文件保存为 UTF-8 编码（Sublime 右下角查看，不是 UTF-8 with BOM）
- 关闭 Sublime 的
detect_indentation（在Preferences → Settings中设"detect_indentation": false），再手动设"tab_size": 4和"translate_tabs_to_spaces": true - 已有混合缩进的文件，先用 Sublime 自带的
Convert Indentation → Convert to Spaces清理一遍，再运行 AutoPEP8 - 如果注释里有中文且被挤到行尾外，大概率是 line-length 参数太小（默认 79），可在插件配置里加
"max_line_length": 99
autopep8 命令没装进环境 PATH、缩进设置和文件编码不匹配。其他都是参数微调的事。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
