autoflake 删除未使用导入导致 pyupgrade 报 importerror，主因是其忽略类型提示和 type_checking 中的导入；需加 --ignore-init-module-imports 等参数，并用 mypy/pyright 验证类型解析。
autoflake 删除未使用导入后，pyupgrade 报 ImportError
常见现象是：跑完 autoflake 后直接上 pyupgrade，结果某些模块突然报 ImportError: cannot import name 'X' from 'Y'。根本原因不是 pyupgrade 出错，而是 autoflake 删得太“干净”——它默认不识别类型提示里的导入（比如 from __future__ import annotations 下的 list[str]），也不管 if TYPE_CHECKING: 块里的导入，直接删掉后，pyupgrade 在重写类型注解时就找不到符号了。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 给
autoflake加--exclude=**/migrations/**和--in-place是基础，但关键要加--ignore-init-module-imports（避免误删__init__.py里用于导出的导入）和--remove-all-unused-imports（显式启用，避免漏删导致后续混乱） - 在
pyupgrade前插入一步：用pyright或mypy --check-untyped-defs快速扫一遍，确认没因删除导入引发类型解析失败 - 如果项目用了
from __future__ import annotations，务必让autoflake跳过类型相关文件或手动保留typing相关导入——autoflake不会主动区分import typing和from typing import List的用途
pyupgrade 把 f-string 升级成 str.format()？不是 bug 是配置冲突
这不是 pyupgrade 反向操作，而是你同时用了旧版 pyproject.toml 里残留的 pyupgrade.keep-f-strings = true 或类似兼容开关，或者被其他工具（如 pre-commit 的旧 hook 配置）覆盖了默认行为。pyupgrade 默认把 .format() 和 % 转 f-string，绝不会反向降级。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 检查
pyproject.toml中是否误写了[tool.pyupgrade]并设置了keep_f_strings = true；删掉整段[tool.pyupgrade]最安全，让它走默认逻辑 - pre-commit hook 中若指定了
args: [--py38-plus]等版本标记，确保它和项目实际支持的最低 Python 版本一致；pyupgrade 对 f-string 的处理严格依赖该标记，标--py36-plus时可能跳过部分转换 - 运行
pyupgrade --py39-plus --exit-non-zero-on-changed *.py手动试一次，看输出是否真有降级——大概率是终端缓存或编辑器自动保存干扰了判断
autoflake + pyupgrade 连用时，__all__ 列表被意外清空
autoflake 默认会删掉所有未被当前模块直接使用的导入，但它不理解 __all__ 是显式导出契约。比如模块里写 from os import path，但只用了 os.path（通过 import os），autoflake 就可能把 from os import path 删掉，而 __all__ = ["path"] 还留着，导致运行时报 NameError: name 'path' is not defined。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- 永远用
autoflake --remove-all-unused-imports --ignore-init-module-imports --in-place，但对含__all__的文件额外加--exclude=*_test.py和人工复查——autoflake 没提供--respect-all这种开关 - pyupgrade 不碰
__all__，所以它不会修复这个问题；真正要靠pylint --enable=unused-import,undefined-variable或pyflakes提前发现导出名未定义 - 更稳妥的做法：把
__all__里的名字全改成字符串（__all__ = ["path", "walk"]），避免 autoflake 误判变量引用关系
CI 中串联执行失败，错误停在 autoflake: command not found
本地好使、CI 报 command not found，基本等于环境没装包。autoflake 和 pyupgrade 都是纯 Python 工具，但它们不进 Python 标准库，必须显式安装。尤其在 Alpine 或最小化镜像里，连 pip 都可能没预装。
实操建议：
立即学习“Python免费学习笔记（深入）”；
- CI 脚本开头必须明确装：用
pip install --no-cache-dir autoflake pyupgrade，别依赖 base 镜像自带 - 如果用 pre-commit，确保
.pre-commit-config.yaml里每个 hook 的rev锁死（如rev: v2.7.1），避免某天 pyupgrade 发新版引入不兼容语法（比如 v3.x 开始要求 Python 3.9+） - 在 CI 中加一句
which autoflake && which pyupgrade，失败时立刻暴露路径问题，比等整个 lint 流程跑完再报错更省时间
这条清理链看着简单，但 autoflake 的“未使用”判定和 pyupgrade 的“可升级”边界都依赖 AST 解析精度，Python 版本微调、future 导入位置、甚至注释格式都可能让它们误判。别迷信一键全量跑通，重点盯住 __all__、类型导入、和 CI 环境隔离这三处。
