pip install git+https://gitlab.example.com/group/project.git@main 可直接安装私有gitlab仓库包，需确保url正确、含认证信息、项目有setup.py/pyproject.toml，且token权限为read_repository。
能发布，但必须分两步走：先推代码到 GitLab 私有仓库，再让 pip 能从该仓库安装——这两件事不自动连通，缺一不可。
怎么把 Python 项目推到私有 GitLab 仓库
核心是确保本地 Git 仓库和远程 GitLab 项目正确关联，并完成首次推送。常见卡点不是命令写错，而是远程 URL 权限或分支名不匹配。
- 创建 GitLab 项目时，记下页面右上角显示的
HTTPS或SSH地址（如https://gitlab.example.com/group/project.git），别直接复制浏览器地址栏里的网页 URL - 本地初始化后，用
git remote add origin <your-gitlab-url></your-gitlab-url>绑定远程，而不是靠 PyCharm 自动识别——自动识别常默认用 SSH，而你的 GitLab 可能只开了 HTTPS 认证 - 首次推送若报错
refusing to allow an OAuth token to create or update a workflow或remote: The project you were looking for could not be found，大概率是 URL 末尾少了.git，或路径中大小写与 GitLab 页面显示不一致 - GitLab 默认主分支名可能是
main而非master，推送时用git push -u origin main；不确定就去 GitLab 项目 Settings → General → Visibility → Default branch 查一眼
怎么让 pip 从私有 GitLab 安装包
GitLab 本身不是 PyPI 服务器，pip install 默认无法直接从 GitLab 仓库 URL 安装，必须借助 Git URL 语法或搭建兼容 PyPI 的索引服务。最轻量、最常用的是 Git URL 方式。
使用 `gh` CLI 与 GitHub 交互。通过`gh issue`、`gh pr`、`gh run` 和 `gh api` 管理 issue、PR、CI 运行以及高级查询。
- 支持的格式是：
pip install git+https://gitlab.example.com/group/project.git@v1.0.0（带 tag）、git+ssh://git@gitlab.example.com/group/project.git#subdirectory=src（指定子目录）、git+https://gitlab.example.com/group/project.git@main#egg=mylib（指定分支 + 包名） - 如果项目根目录没有
setup.py或pyproject.toml，pip会安装失败并提示FileNotFoundError: No setup.py or pyproject.toml——不是权限问题，是结构缺失 - 私有仓库需认证：HTTPS 方式需在 URL 中嵌入 token，如
git+https://oauth2:<your_token>@gitlab.example.com/group/project.git</your_token>；SSH 方式则依赖本地~/.ssh/id_rsa是否已添加到 GitLab 账户 SSH Keys 中 - 不建议在
requirements.txt中硬编码 token，应改用pip install --trusted-host gitlab.example.com -i https://pypi.org/simple/ -r requirements.txt配合环境变量PIP_INDEX_URL或配置文件统一管理凭据
为什么 pip install xxx 报 ModuleNotFoundError，即使代码已推到 GitLab
因为 pip install xxx 默认只查 PyPI，不会主动扫描你的 GitLab。除非你显式告诉它“去那里找”，否则它根本不知道那个库存在。
- 错误现象：
ModuleNotFoundError: No module named 'mylib'，但git clone https://gitlab.example.com/group/project.git能成功 —— 这说明网络和权限没问题，只是pip没被指路 - 不要尝试
pip install mylib（期望它自动发现 GitLab 上同名库），PyPI 上没这个包，pip就不会继续往 GitLab 查 - 临时验证是否可行：运行
pip install git+https://gitlab.example.com/group/project.git，成功即证明代码结构、认证、网络全部 ok；失败则按上一条检查具体报错 - 若项目含 C 扩展或需编译，GitLab URL 安装默认走源码构建，可能因缺少
build-essential或python-dev报错，此时需确认目标环境是否满足构建依赖
想实现 pip install mylib 就自动从私有 GitLab 装，怎么办
技术上可行，但代价高：你需要部署一个兼容 PyPI 协议的私有索引服务（如 devpi、Artifactory 或 PyPI-Server），再把 GitLab 仓库打包上传过去，并配置 pip 默认使用该索引。对多数团队，这属于过度设计。
- 更务实的做法是：在项目
requirements.txt里写明 Git URL，CI/CD 流水线用pip install -r requirements.txt直接拉；开发机则用pip install -e git+https://...#egg=mylib进入可编辑模式 - 如果坚持要透明安装，唯一低侵入方式是修改用户级
pip配置（~/.pip/pip.conf或%APPDATA%\pip\pip.ini），加index-url = https://your-pypi-proxy/simple/，但该 proxy 必须真实存在并同步了你的包 - 切勿用
--find-links指向 GitLab 项目页面 HTML（如https://gitlab.example.com/group/project/-/tree/main），pip不解析这种页面，只会报404 Client Error
真正容易被忽略的是：GitLab 项目 visibility 设置为 Private 后，token 权限必须勾选 read_repository（HTTPS）或对应 SSH key 已授权，且 pip 命令中 URL 的协议、域名、路径、分支/Tag 名称，四者必须与 GitLab 页面展示的完全一致——差一个字符，就是 404 或 403。
Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
