可编辑模式下安装 python 包

可编辑模式下安装 python 包

一般情况下, 我们使用的是 pip install pkg 来完成包的安装, 默认的安装的目标目录在 site-packages 下, 这种情况非常适合我们引用某些成熟包.
如果我们想要给github某个项目贡献PR, 或者仅仅要魔改一下某个项目, 可以使用 editable 模式来安装.
editable 模式的优点有:

• 安装的目标目录可以使任意目录, 不需要放到 site-packages, 后者不适合作为源码的存放目录.
• 编辑的是未经打包的源码文件, 方便提PR.

git clone https://github.com/ultralytics/ultralytics

# Navigate to the cloned directory
cd c:\ultralytics

# Install the package in editable mode for development
pip install -e  c:\ultralytics

如何解决无法import 编辑模式下安装 python 包

正常情况下, 编辑模式下安装的Python包, 可以像正常模式安装的一样直接引用即可, 但偶尔会报无法import的异常, 解决方法有:

• 将该包加入 PYTHONPATH 环境变量中, 但这个方法需要注意是否对其他 virtual env有影响.
• 在 site-packages 目录下, 新建一个 .pth 文本文件, 文件名不限, 比如 aaa.pth, 文件中每行可以引入一个路径, 可以写多行. 如果有多个 virtual env 推荐使用这个方法.

aaa.pth 文件示例:

/path/to/requests_v1
/path/to/requests_v2
/path/to/requests_v3