这种跨环境用requirements.txt装依赖踩坑太常见了，我整理了几个通用的解决办法，你按优先级试试应该能搞定：

1. 重新生成干净的requirements文件 #

很多时候问题根源是你原来的requirements里混了本地路径或者特定环境的绝对引用——比如直接用pip freeze > requirements.txt时，会把你本地开发的 editable 包（比如-e file:///xxx这种格式）也写进去，换机器肯定找不到这些路径。

解决办法：

• 手动梳理依赖，只保留PyPI上能找到的包名和合理版本约束；
• 用依赖管理工具生成更干净的文件：
  • 用Poetry的话：poetry export --without-hashes -f requirements.txt --output requirements.txt
  • 用Pipenv的话：pipenv lock --requirements > requirements.txt
  • 原生pip环境的话，先确保虚拟环境里只有项目必需的依赖，然后执行：
    • Linux/macOS：pip list --format=freeze | grep -v "^-e" > requirements.txt
    • Windows：pip list --format=freeze | findstr /v "^-e" > requirements.txt
      （这条命令会过滤掉本地 editable 包的路径引用）

2. 放宽版本约束，避免源码编译陷阱 #

如果你的requirements里写死了某个包的精确版本，而这个版本在目标机器的系统/架构下没有预编译的wheel包，pip就会尝试从源码编译。源码编译需要依赖系统级的工具和库（比如Python开发头文件、gcc编译器），缺了就会报「文件/目录不存在」。

解决办法：

• 把精确版本号改成兼容范围，比如把requests==2.28.1改成requests>=2.28,<3，或者用波浪号约束requests~=2.28（表示兼容2.28.x的小版本更新）；
• 对numpy、pandas、PyTorch这类依赖系统库较多的包，可以先不指定版本，让pip自动适配目标环境，安装完成后再用pip freeze锁定稳定版本。

3. 补全目标机器的系统级依赖 #

当源码编译不可避免时，必须先安装目标机器缺失的系统工具和库：

• Linux：比如需要安装python3-dev（Python开发头文件）、gcc、g++、make，还有对应包的专属依赖——比如装cryptography要libssl-dev，装mysqlclient要libmysqlclient-dev；
• macOS：先装Xcode Command Line Tools（执行xcode-select --install），再用Homebrew补装需要的库，比如brew install openssl；
• Windows：安装Visual Studio Build Tools，勾选「C++开发工具」组件，或者找对应包的预编译wheel文件手动安装。

4. 强制优先使用wheel预编译包 #

wheel是预编译的包格式，能跳过源码编译的坑，强制pip优先选wheel：

• 先安装wheel工具：pip install wheel；
• 安装依赖时加上--prefer-binary参数：pip install --prefer-binary -r requirements.txt；
• 如果所有依赖都有wheel包，也可以用--only-binary :all:参数彻底禁止源码编译：pip install --only-binary :all: -r requirements.txt

5. 清理requirements中的本地路径引用 #

仔细检查你的requirements.txt，有没有类似下面的行：

-e /home/yourname/your-local-package
mypackage @ file:///C:/Projects/mypackage

这些都是指向你本地文件的引用，换机器肯定找不到，直接删掉这些行：

• 如果是自己开发的包已经传到PyPI了，换成包的PyPI名称；
• 如果还是本地开发包，在目标机器上把项目文件放好后，再用-e .（相对路径）来安装。

6. 统一Python版本和系统架构 #

如果两台机器的Python版本差太多（比如原环境是3.8，目标是3.11），或者架构不同（比如原环境是x86_64，目标是ARM），也可能导致包不兼容而报错：

• 尽量保证两台机器的Python大版本一致（比如都是3.10.x）；
• 对于架构差异，优先找支持目标架构的wheel包，或者确认包是否官方支持该架构。

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