PyCharm同步Python依赖的内部实现及命令行替代方案

原理说明 #

PyCharm的「Sync Python Requirements」核心靠静态代码分析实现精准导出：

• 遍历项目目录下所有Python文件，通过语法解析识别代码里的import语句（包括from ... import ...等形式）
• 匹配导入模块对应的PyPI包名（部分模块名和包名不一致，比如PIL对应包pillow）
• 结合当前环境已安装的包版本，生成仅包含项目实际依赖的清单，还能自动递归处理依赖的子依赖

命令行实现方法 #

不想依赖PyCharm的话，可通过以下工具实现相同效果：

1. pipreqs（推荐） #

专门针对项目依赖分析的工具，仅导出实际用到的包：

• 安装：pip install pipreqs
• 项目根目录执行：pipreqs . --encoding=utf8 --force
  • --encoding=utf8：解决中文注释引发的编码错误
  • --force：覆盖已存在的requirements.txt文件

2. pigar #

支持更复杂导入场景的静态分析工具：

• 安装：pip install pigar
• 项目根目录执行：pigar

3. 手动筛选（适合小型项目） #

无需额外工具时，可先导出全量包再手动精简：

1. 导出当前环境所有包：pip freeze > temp.txt
2. 遍历项目代码整理用到的包列表，对比temp.txt删除无关条目，最终保存为requirements.txt

注意事项 #

• 动态导入（比如importlib.import_module()）无法被静态分析工具识别，这类情况需要手动补充对应包到清单
• 配合虚拟环境使用能进一步减少无关包干扰

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