Ctrl + Alt + L 默认格式化当前整个文件，按PEP 8全面重排代码（缩进、空格、换行等）；选中代码后则仅格式化所选区域。
Ctrl + Alt + L 能格式化什么
这个快捷键默认作用于当前打开的整个文件，不是只修缩进，而是按项目配置的 Python 代码风格（通常是 PEP 8）全面重排：调整空格、对齐括号、规范运算符前后间距、拆分过长行、统一换行位置、处理空行数量。它不会改逻辑，但会把 def foo():a=1 变成 def foo():\n a = 1。
常见误判是以为它只解决黄色波浪线——其实波浪线多由 PEP 8 检查器触发，而 Ctrl + Alt + L 是执行器，两者配合才闭环。如果格式化后仍有波浪线，大概率是风格配置没生效，或用了不兼容的第三方 formatter（如 black 未正确集成）。
选中代码再按 Ctrl + Alt + L 的行为差异
只要提前用鼠标或 Shift+方向键选中一段代码，Ctrl + Alt + L 就只格式化该区域，而不是整文件。这个细节容易被忽略，尤其在调试时想局部调参却意外重排了整个模块。
PyCharm 2026.2是 JetBrains PyCharm 的指定版本安装包，下载地址指向官方 Windows 安装包直链，可用于旧项目兼容、版本回退和环境测试。
- 选中
if x > 0 and y 这类长条件，格式化后可能自动折成多行并保持逻辑清晰 - 若选中含注释的代码块，是否保留注释缩进取决于设置里的
Keep when reformatting → Comments是否勾选 - 选中后执行，对话框里会自动激活
Selected text模式，此时勾选Optimize imports无效——import 整理只对整个文件起作用
批量格式化目录时 import 整理容易出错
右键目录 → Reformat Code… 并勾选 Optimize imports 看似省事，但实际风险不小：
- 它会删掉所有未显式使用的
import，包括那些仅用于 type hinting 的（如from typing import Optional），除非你在设置里开了Do not optimize imports with forward references - 跨文件的相对导入（如
from ..utils import helper）可能被误判为未使用，尤其当目标模块在当前扫描范围外 - 如果项目混用
black和 PyCharm 内置格式器，Optimize imports的排序规则（按 ASCII）和isort默认规则不一致，会导致 Git diff 频繁抖动
保存时自动格式化要避开 .editorconfig 冲突
启用 Settings → Tools → Save Actions → Reformat code 很方便，但前提是项目根目录没有 .editorconfig 文件，或者该文件里没写 indent_style、max_line_length 这类覆盖项。PyCharm 优先读 .editorconfig，一旦里面写了 indent_size = 2 而你 IDE 设置是 4，保存时就会按 2 格缩进，且不提示冲突。
真正麻烦的是混合团队：有人用 VS Code + black，有人用 PyCharm + 内置格式器，.editorconfig 里若只写 indent_style = space 不写 indent_size，PyCharm 会 fallback 到自己设置，而 black 固定用 4——结果就是每次提交都带一堆无关缩进变更。
