使用uv共享含私有Git依赖的Python虚拟环境遇阻求助

这是Git凭证未正确配置/传递导致的问题，uv本身支持私有仓库依赖的共享，核心问题出在认证环节和依赖记录的处理上。

报错关键点拆解 #

• fatal: could not read Username for 'https://bitbucket.org'：Git拉取私有仓库时无可用认证凭证，导致访问失败。
• Illegal characters in path：Windows路径包含特殊字符，干扰Git操作。
• 你最初用uv add git+https://<username>:<token>@bitbucket.org/<repo>添加依赖时，uv不会将敏感凭证写入pyproject.toml（或会自动剥离），导致共享后的环境无法获取认证信息。

解决步骤 #

1. 移除依赖URL中的硬编码凭证
   编辑项目的pyproject.toml，将依赖项里的git+https://<username>:<token>@bitbucket.org/<repo>替换为干净的仓库地址：git+https://bitbucket.org/<repo>。硬编码凭证既不安全，也无法在共享环境中正常传递。

2. 配置Git凭证管理器
   让Git自动处理私有仓库的认证，无需每次手动输入凭证：

   • Windows系统执行：

     git config --global credential.helper manager-core
     

   • 首次拉取私有仓库时，输入你的Bitbucket/GitHub用户名和个人访问令牌（PAT），Git会自动保存凭证，后续操作无需重复输入。

3. 清理非法路径字符
   检查项目路径和uv缓存路径（C:\Users\<username>\AppData\Local\uv\...），确保路径中没有中文、空格或特殊符号，改用纯英文、无空格的路径，解决Illegal characters in path报错。

4. 验证凭证有效性
   在目标环境中先手动执行：

   git clone https://bitbucket.org/<repo>
   

   如果手动能正常拉取仓库，说明凭证配置正确，此时再使用uv add ..\<original project name>共享环境，uv就能正常下载构建私有仓库包。

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