如何仅导入本地克隆的Python包而非PyPI版本？

方法1：使用pip可编辑安装（推荐） #

这是长期开发本地包最便捷的方案，既能让本地修改实时生效，又能确保Python优先加载本地版本：

• 打开终端，进入你克隆的本地仓库根目录（该目录下存在setup.py或pyproject.toml文件）
• 执行命令：

  pip install -e .
  

  此命令会将本地包以「可编辑模式」注册到Python环境，后续修改本地代码无需重新安装即可生效，Python会自动优先读取本地版本。

方法2：临时修改sys.path（适合单次测试） #

如果只是临时验证本地代码，不想改动全局环境，可在脚本开头添加代码强制Python优先搜索本地路径：

import sys
import os

# 替换为你本地克隆仓库的绝对根路径
local_repo_path = "/absolute/path/to/your/local/package"
# 将本地路径插入到搜索列表最前端
sys.path.insert(0, local_repo_path)

# 之后正常导入包即可
import your_package_name

方法3：卸载PyPI版本（适合仅用本地版本的场景） #

如果暂时不需要PyPI上的官方版本，可直接卸载它，确保Python只能找到本地克隆的包：

• 执行命令卸载PyPI版本：

  pip uninstall your_package_name
  

• 之后确保本地仓库路径在Python搜索范围内，可通过设置PYTHONPATH环境变量，或用方法2的sys.path修改方式实现。

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