pyupgrade：自动升级 Python 代码语法的工具

pyupgrade：自动升级 Python 代码语法的工具

Python 版本迭代很快，3.8 有了海象运算符，3.9 有了内置泛型，3.10 有了联合类型|。但老代码库里的写法往往还停留在几年前，手动逐行升级费时费力。

pyupgrade 就是专门解决这个问题的。这个项目目前有 4,094 Star，作者是 asottile。它的核心能力很直接：扫描 Python 代码，自动把旧语法替换成新语法，不改变代码的运行逻辑。

支持的重写规则

pyupgrade 覆盖的语法升级范围很广，从 Python 2 兼容代码到 Python 3.13 的新特性都有。

集合与字典。set([1, 2])会改成{1, 2}，dict((a, b) for a, b in y)会改成{a: b for a, b in y}。这类改动直接减少代码量，可读性也更好。

字符串格式化。可以把'%s %s' % (a, b)和'{}'.format(a, b)自动转成 f-string。工具比较保守，如果转换会让表达式变长或更复杂，就不会强行替换。

类型注解重写。PEP 585 的List[str]改成list[str]，PEP 604 的Optional[str]改成str | None，PEP 696 的Generator[int, None, None]改成Generator[int]，都能自动处理。

super() 简化。Python 3 里super(C, self).f()可以直接写成super().f()，pyupgrade 会统一做这种替换。

去除兼容层。如果项目确定只支持 Python 3，pyupgrade 可以删除six库的兼容代码、__future__import、冗余的io.open调用，以及__metaclass__ = type这类在新版本里不需要的声明。

标准库 API 更新。比如stdout=subprocess.PIPE, stderr=subprocess.PIPE改成capture_output=True，@functools.lru_cache(maxsize=None)改成@functools.cache，datetime.timezone.utc改成datetime.UTC。这些细微的 API 变化，单独改很琐碎，交给工具批量处理更合适。

使用方式

安装和运行都很简单：

pip install pyupgrade pyupgrade --py38-plus myfile.py

--py38-plus表示目标 Python 版本是 3.8 以上，工具会据此决定哪些重写规则可以应用。支持对单个文件或整个目录批量处理。

更推荐的做法是配置成 pre-commit hook。在.pre-commit-config.yaml里加上几行配置，每次提交代码时自动运行，代码库的语法标准会始终保持在设定版本上。

适用场景

维护老旧 Python 项目的团队，如果想逐步迁移到新语法，pyupgrade 能省掉大量重复劳动。它只改语法形式，不动业务逻辑，风险很低。

新项目也可以把它集成到 CI 里，防止旧写法进入代码库。配合 black、isort 这类格式化工具一起用，代码风格和质量都能统一管起来。

总之，语法升级这种机械劳动，交给自动化工具更合适。

用，代码风格和质量都能统一管起来。

总之，语法升级这种机械劳动，交给自动化工具更合适。