如何让pip仅显示手动安装的包而非依赖安装的包？解决requirements.txt升级依赖冲突问题

这个问题我太懂了——用pip freeze导出的requirements.txt塞满依赖包，升级时简直是冲突重灾区！尤其是维护多个项目的时候，真的头大。下面给你几个实用的解决方案，从原生命令到工具辅助都有：

1. 原生pip对比法（无需额外工具） #

如果你的项目用了虚拟环境，可以利用虚拟环境的初始状态过滤出手动安装的包：

• 新建虚拟环境后，先导出初始状态的空包列表：

  pip freeze > initial_requirements.txt
  

• 安装完所有需要的包后，再导出当前环境的完整包列表：

  pip freeze > current_requirements.txt
  

• 用comm命令（Linux/macOS）对比两个文件，提取差异（也就是你手动安装的包）：

  comm -23 <(sort current_requirements.txt) <(sort initial_requirements.txt) > manual_requirements.txt
  

  Windows用户可以用PowerShell的Compare-Object命令，或者直接用文本编辑器的差异对比功能。

2. 用pipdeptree提取顶层包 #

pipdeptree是专门展示pip依赖树的工具，能快速定位到你手动安装的顶层包：

• 先安装工具：

  pip install pipdeptree
  

• 运行以下命令导出仅顶层包的列表：

  pipdeptree --freeze --warn silence | grep -E '^[a-zA-Z0-9\-]+==' > manual_requirements.txt
  

  这个命令会自动过滤掉依赖包，只保留你主动安装的那些核心包。

3. 用pipreqs扫描项目代码生成需求 #

如果你的项目代码已经写好，pipreqs可以扫描代码中实际导入的包，自动生成精准的requirements.txt，完全忽略未被引用的依赖：

• 安装工具：

  pip install pipreqs
  

• 切换到项目根目录，运行命令：

  pipreqs . --force
  

  --force参数会覆盖已有的requirements.txt，生成的文件里只有代码中真正用到的包，完美匹配你的需求。

4. 长期维护方案：用pip-tools管理需求 #

如果想彻底解决升级冲突问题，推荐用pip-tools分离手动维护的包和自动生成的依赖：

• 安装工具：

  pip install pip-tools
  

• 在项目根目录创建requirements.in文件，只写你手动安装的包（比如）：

  elasticsearch==7.14.0
  matplotlib==3.4.3
  numpy==1.21.2
  pytz==2021.1
  

• 运行pip-compile生成包含所有依赖的requirements.txt：

  pip-compile requirements.in
  

• 以后升级包时，只需要修改requirements.in里的版本号，再重新运行pip-compile，工具会自动处理依赖版本的兼容性，从根源避免冲突。

pip freeze的设计目标是列出当前环境中所有已安装的包，不管是你手动pip install的，还是安装某个包时自动拉取的依赖。把这个直接存为requirements.txt，会把所有依赖的版本都固定死，后续升级时很容易出现不同包对同一依赖的版本要求冲突的情况。

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