从现有项目创建虚拟环境并导出依赖至environment.yml/requirements.txt遇问题

我来帮你解决这个导出项目依赖的问题——很多人第一次从无虚拟环境的开发模式转过来都会遇到这些坑，咱们一步步来梳理原因和解决方案：

为什么你的操作没得到预期结果？ #

先搞清楚问题出在哪：

• conda导出空文件：你是先创建了全新的虚拟环境，这个环境本身没有安装任何项目依赖，直接执行conda env export自然只会导出环境的基础配置（比如Python版本），没有具体依赖包
• pip freeze导出大量无关模块：如果是在系统全局环境下执行pip freeze --local，--local并不会过滤系统自带的包——因为全局环境本身就是你的“本地”环境，所以会把所有全局安装的模块都列出来，而其中大部分和你的项目无关

方案一：精准识别项目实际依赖（最推荐） #

最靠谱的方式是直接扫描项目代码，找出实际导入的包，避免冗余。推荐用这两个工具：

使用pipreqs（轻量快速） #

1. 先激活你准备好的虚拟环境（不管是空的还是全局环境，建议用全新空环境）
2. 安装工具：pip install pipreqs
3. 切换到项目根目录，执行：pipreqs . --force
   • --force参数用于覆盖已有的requirements.txt文件
4. 生成的requirements.txt只会包含项目代码里实际导入的包，完全没有无关内容
   • 注意：如果项目里有动态导入的包（比如用importlib导入的），需要手动补充到文件里

使用pigar（功能更全面） #

这个工具不仅能识别依赖，还能检测包的版本、找出未使用的依赖：

1. 安装工具：pip install pigar
2. 进入项目根目录执行：pigar
3. 它会自动生成requirements.txt，还会标注每个包的版本建议，甚至提醒你哪些包已经安装但没在代码里用到

方案二：从全局环境筛选依赖（适合快速处理） #

如果不想用第三方工具，可以通过对比全局环境和空虚拟环境的包列表来筛选：

1. 在全局环境执行：pip freeze > all_global_packages.txt
2. 创建并激活一个全新的空虚拟环境：
   • Conda方式：conda create -n empty_env python=3.x，然后conda activate empty_env
   • Pip虚拟环境方式：python -m venv empty_env，激活后执行pip freeze > empty_env_packages.txt
3. 对比两个文件，提取全局环境独有的包：
   • Linux/macOS：用命令diff empty_env_packages.txt all_global_packages.txt | grep '>' | sed 's/> //' > requirements.txt
   • Windows：可以用PowerShell的Compare-Object命令，或者手动筛选（比较麻烦，还是推荐工具法）
4. 最后手动检查requirements.txt，去掉明显无关的包（比如pip、setuptools这类系统自带工具）

正确导出Conda环境文件environment.yml #

如果想用Conda来管理环境并导出environment.yml，步骤要调整：

1. 先把项目依赖安装到目标Conda环境里：
   • 可以先用上面的方法生成requirements.txt，然后在Conda环境里执行pip install -r requirements.txt
   • 如果有可用的Conda包，优先用conda install 包名安装
2. 激活这个Conda环境，执行：conda env export --from-history > environment.yml
   • --from-history是关键参数！它只会导出你手动通过conda install安装的包，不会包含间接依赖，文件更简洁，非常适合Docker构建
   • 如果需要包含所有依赖（包括间接依赖），去掉--from-history即可，但这样生成的文件会很大，Docker镜像体积也会增加

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