激活虚拟环境(venv)时.netrc失效，无法免密安装GitLab私有PyPI包

1. 给虚拟环境安装密钥环依赖 #

虚拟环境的Python是独立隔离的，默认不会继承系统Python的keyring包，激活虚拟环境后执行：

(venv) pip install keyring keyrings.alt

keyrings.alt提供了跨平台的备用密钥环后端，确保在不同桌面环境下都能正常访问系统密钥存储。

2. 确保pip启用密钥环功能 #

打开用户级pip配置文件~/.config/pip/pip.conf，添加use-feature=keyring配置项：

[global]
extra-index-url=https://gitlab.example.com/api/v4/groups/60/-/packages/pypi/simple
use-feature=keyring

对于pip 21.0及以上版本，该特性默认启用，但显式声明可以避免版本兼容问题。

3. 验证虚拟环境对密钥环的访问权限 #

在虚拟环境中运行以下代码，测试是否能读取存储的GitLab密码：

(venv) python -c "import keyring; print(keyring.get_password('gitlab.example.com', 'my_username'))"

如果能正常输出密码，说明密钥环访问正常；如果报错，检查系统密钥环服务是否运行（比如Linux下的gnome-keyring-daemon），或者确认当前用户对密钥环有访问权限。

4. 备选方案：使用含认证信息的索引地址 #

如果上述方法无法解决，可以临时将GitLab个人访问令牌（需具备read_api和read_repository权限）嵌入索引地址：

[global]
extra-index-url=https://my_username:your_personal_access_token@gitlab.example.com/api/v4/groups/60/-/packages/pypi/simple

注意：此方法会明文存储令牌，仅在测试或非敏感环境中使用。

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