如何用pip以可编辑/开发模式安装本地Git仓库特定分支

要实现本地Git仓库的**开发模式（develop mode）**安装，让你修改代码后无需反复重装，只需在pip install -e命令中结合本地Git路径与分支指定即可，具体格式如下：

pip install -e git+file:///本地仓库绝对路径@目标分支名#egg=包名称

各部分说明： #

• -e：启用开发模式，pip会在你的Python环境中创建指向本地仓库的软链接，代码修改后直接生效，无需重新安装。
• git+file:///：指定安装源为本地Git仓库（三个斜杠是标准格式，确保路径识别正确）。
• @目标分支名：指定要安装的仓库分支，pip会自动检出该分支的代码。
• #egg=包名称：给安装的包指定一个名称，避免pip因无法识别包名报错，名称可与仓库内setup.py或pyproject.toml中定义的包名一致。

示例： #

假设你的本地仓库绝对路径是/home/yourname/my-project，目标分支是dev，包名是my-project，命令如下：

pip install -e git+file:///home/yourname/my-project@dev#egg=my-project

Windows系统下路径格式示例（注意盘符前的斜杠）：

pip install -e git+file:///C:/Users/yourname/my-project@dev#egg=my-project

使用注意： #

1. 安装完成后，你可以直接在本地仓库目录内切换分支、修改代码，所有变更会实时同步到已安装的包中。
2. 如果需要切换到其他分支，重新执行上述命令并替换分支名即可，pip会自动更新软链接指向的分支代码。
3. 确保本地仓库已初始化Git且目标分支存在，否则pip会报错。

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