如何高效完成Python 3.6至3.10代码迁移？

一、依赖包兼容性分析（处理 requirements.txt） #

针对依赖包的版本兼容性检查，这些工具能帮你快速定位问题：

• pip-check-reqs：指定目标Python版本扫描requirements.txt，识别不兼容3.10的包。执行命令：

  pip-check-reqs --python-version 3.10 requirements.txt
  

  得到不兼容包后，可通过包的PyPI页面或官方文档查询支持3.10的最低版本。
• pip-audit：通过分析包的元数据，辅助判断依赖对Python 3.10的支持情况，同时兼顾安全审计。
• safety：除了检测安全漏洞，还能关联包的Python版本支持信息，筛选出不适配3.10的依赖。

二、代码库API/语法兼容性扫描 #

这些工具能批量识别代码中使用的已移除或弃用特性：

• pyupgrade：专注于代码语法升级，可识别3.6到3.10中移除的语法、弃用的标准库函数，还能自动修复部分问题。执行命令：

  pyupgrade --py310-plus **/*.py
  

• flake8 + flake8-deprecated插件：用flake8做基础代码检查，搭配flake8-deprecated插件可精准标记代码中使用的已弃用函数/方法。安装插件后执行：

  flake8 your_code_directory/
  

• pylint：配置python-version=3.10后，它会扫描代码中使用的、在3.10中已移除或弃用的模块、函数，并给出详细告警。
• caniusepython3：扫描代码依赖的特性是否在Python 3.10中被移除或变更，帮你定位不兼容的代码片段。

实操建议 #

先完成依赖包的兼容性更新，再用代码扫描工具批量定位问题，最后针对性修复，比直接在3.10环境跑代码碰报错的效率高很多。

内容的提问来源于stack exchange，提问作者yi1