如何将GitLab私有实例中的Python包作为依赖项配置到同实例的另一个私有Python包

我太懂你现在的困扰了——在GitLab私有实例里折腾私有Python包的依赖，直接在pyproject.toml里写索引地址居然报404，属实头疼。其实问题出在pip处理私有依赖时的认证和地址格式要求上，下面给你几个实用的解决办法：

方法一：用pip配置文件管理认证与索引（推荐） #

直接把token写在依赖里既不安全也不好维护，咱可以用项目级的pip配置文件来处理：

1. 在你的主包项目根目录创建pip.conf（Linux/macOS）或者pip.ini（Windows），内容如下：

[global]
# 主包的索引地址
index-url = https://__token__:<你的个人令牌>@<实例地址>/api/v4/projects/1050/packages/pypi/simple
# 依赖包的额外索引地址
extra-index-url = https://__token__:<你的个人令牌>@<实例地址>/api/v4/projects/1064/packages/pypi/simple

2. 把这个配置文件加入.gitignore，绝对不能提交到Git，避免令牌泄露！
3. 修改pyproject.toml的依赖部分，只写包名（或指定版本）就行：

dependencies = [
    "<package>", # 或者指定版本如"<package>==1.0.0"
    "spacy==3.7.5",
    "opencv-python==4.10.0.84",
    # ...其他依赖保持不变
]

这样pip安装主包时，会自动从两个私有索引里找对应的包，包括你的依赖私有包。

方法二：直接使用带认证的完整包归档URL（应急用，不推荐） #

如果只是临时测试，你可以把依赖包的完整归档URL（不是索引地址）写到pyproject.toml里，格式如下：

dependencies = [
    "<package> @ https://__token__:<你的个人令牌>@<实例地址>/api/v4/projects/1064/packages/pypi/files/<包文件的具体路径>/<package>-<版本号>.tar.gz",
    # ...其他依赖
]

⚠️ 注意：这个方法弊端很多，每次依赖包更新都要手动改URL，而且令牌直接暴露在配置文件里，风险很高，只适合临时场景。

方法三：GitLab CI/CD环境用内置令牌 #

如果你的主包是在GitLab CI里构建的，完全不用个人令牌，用CI自带的CI_JOB_TOKEN就行，在CI配置文件里这么写：

build_package:
  script:
    - pip install . --index-url https://gitlab-ci-token:$CI_JOB_TOKEN@<实例地址>/api/v4/projects/1050/packages/pypi/simple --extra-index-url https://gitlab-ci-token:$CI_JOB_TOKEN@<实例地址>/api/v4/projects/1064/packages/pypi/simple

同时pyproject.toml里的依赖只保留包名即可，CI会自动处理认证和索引。

额外检查点 #

最后再帮你排查几个可能踩坑的地方：

• 确认你的个人令牌有读取1064项目包和读取1050项目的权限，权限不够也会报404
• 核对索引地址的拼写：项目ID、实例地址、结尾的/simple都不能错
• 确保pyproject.toml的build-system配置正确，setuptools版本符合要求

备注：内容来源于stack exchange，提问作者Shaker