pip从含#符号分支名的远程Git仓库安装Python包报错问题咨询

故障解决方案 #

问题根因 #

URL 中#属于内置片段标识符，pip 及底层 URL 解析逻辑会默认将#之后的内容识别为独立 URL 片段，而非分支名的组成部分，因此触发截断报错。

操作步骤 #

• 仅将分支名称中的#替换为 URL 编码格式的%23，不要对 URL 中://、@、/等合法字符做编码
• 给完整的 Git 安装路径用单引号包裹，避免 Shell 环境提前解析特殊字符

可用命令示例 #

pip install 'git+https://dev.azure.com/repository@branch/%23name-with-hash'

通用规则 #

如果分支名包含空格、&、?等其他特殊字符，都可以用对应 URL 编码替换后配合单引号包裹的方式解决解析错误，该方案对 GitHub、GitLab 等其他 Git 平台的 pip 安装场景同样生效。

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