通过requirements.txt在venv安装共享目录Python包失败求助

问题根源 #

用pip install -e安装的可编辑（editable）包，pip freeze会生成本地绝对路径（比如-e f:\folder0\folder1\folder2\folder3\package_name），但另一台机器的共享目录挂载路径、盘符大概率和原机器不一致，直接复用这个路径必然找不到包。改双反斜杠没用，核心问题是路径本身不匹配，而非转义问题。

可行解决方案 #

1. 改用相对路径（推荐，适合同结构共享目录场景） #

如果两台机器的共享目录相对于venv或requirements.txt的位置一致，把绝对路径改成相对路径。比如：

• 若新机器venv在g:\projects\my_venv，共享包在g:\shared\package_name，则写-e ../shared/package_name
• 若requirements.txt在g:\projects\my_project\requirements.txt，包在g:\shared\package_name，则写-e ../../shared/package_name

2. 使用UNC路径（Windows环境专属） #

改用UNC路径替代盘符路径，避免盘符映射差异问题。比如：

-e //server_name/shared_folder/folder0/folder1/folder2/folder3/package_name

或者Windows格式的UNC（注意反斜杠需转义为双反斜杠）：

-e \\server_name\shared_folder\folder0\folder1\folder2\folder3\package_name

也可以直接用正斜杠，pip支持正斜杠作为路径分隔符。

3. 上传到私有PyPI仓库（适合多团队协作） #

如果频繁跨机器安装，把包打包后上传到公司内部私有PyPI仓库，requirements.txt里只需写包名和版本号：

package_name==1.0.0

安装时pip install -r requirements.txt会直接从私有仓库拉取，彻底规避路径问题。

4. 手动适配本地路径（临时解决） #

在新机器上直接运行适配本地的pip install -e命令，再重新生成requirements.txt：

pip install -e g:\shared\folder0\folder1\folder2\folder3\package_name
pip freeze > requirements.txt

生成的路径就是新机器的有效路径，后续在该机器上安装即可正常运行。

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