推荐用pip config命令配置用户级或项目级私有仓库，避免污染全局环境；项目级执行pip config --site set global.index-url https://pypi.yourcorp.com/simple/，支持token认证且需确保/simple/端点可用。
用 pip config 配置私有仓库，别碰全局 pip.conf
直接改系统级 pip.conf 或 pip.ini 容易污染所有项目环境，尤其在 CI/CD 或多项目共存时会引发依赖错乱。推荐用 pip config 命令写入用户级或项目级配置，优先级更可控。
- 项目级（推荐）：在项目根目录下执行
pip config --site set global.index-url https://pypi.yourcorp.com/simple/，会生成.pip/pip.conf并自动被识别 - 若需认证，不要明文写密码：用
pip config set global.extra-index-url https://__token__:your_api_token@pypi.yourcorp.com/simple/，多数私有仓库（如 Nexus、Artifactory、devpi）支持 token 认证 - 避免同时设
index-url和extra-index-url指向同一域——pip 会去重但可能跳过认证头，导致 401
setup.py 中指定 upload 仓库时，--repository 必须匹配 .pypirc 的 section 名
运行 python -m twine upload 时，--repository 参数不是 URL，而是 .pypirc 文件里的 section 标签名。名字对不上就报 RepositoryError: No repository named 'xxx'。
-
.pypirc示例（放在用户主目录）：[distutils] index-servers = corp [corp] repository = https://pypi.yourcorp.com username = __token__ password = pypi-xxxxx...
- 上传命令必须为
twine upload --repository corp dist/*.whl，不能写成--repository https://... - 如果用 Poetry，对应配置是
poetry config repositories.corp https://pypi.yourcorp.com，再通过poetry publish --repository corp推送
私有包 install 时出现 “Could not find a version that satisfies…” 的真实原因
这错误常被误认为网络不通，实际多数是仓库返回了 200 状态页（比如登录页 HTML），但 pip 解析 simple API 时只认纯文本响应。典型触发场景：
- 仓库启用了 Web 登录页（如 Nexus 默认首页），而没启用
/simple/端点；确认访问https://pypi.yourcorp.com/simple/能直接列出包名目录，且响应头含Content-Type: text/html（注意：必须是 text/html，不是 application/json） - 反向代理（如 Nginx）漏传了
Authorization头，导致 401 后重定向到登录页——检查代理配置中是否包含proxy_pass_request_headers on; - 包名大小写不一致：私有仓库对包名大小写敏感，而 PyPI 不敏感；
pip install MyPackage可能失败，但pip install mypackage成功（取决于你打包时name字段的写法）
CI/CD 中避免硬编码凭证，用环境变量注入 token
GitHub Actions、GitLab CI 等平台不建议把 token 写进 .pypirc 文件提交，也不该用 pip config set 在 job 中动态写入（权限残留风险）。正确做法是让 twine 直接读环境变量。
- 设置环境变量：
TWINE_USERNAME=__token__+TWINE_PASSWORD=pypi-xxxxx... - 上传命令简化为
twine upload --repository-url https://pypi.yourcorp.com/simple/ dist/*.whl，twine 会自动取用 - 注意：某些旧版 twine（--repository-url 与环境变量混用，升级到最新版可规避
/simple/ 接口行为一致性——它不像 PyPI 那样容错，少一个 trailing slash、多一层重定向、响应头类型不对，都会让 pip 静默失败。调试时先用 curl -I 看状态码和头，比盲试 pip 命令快得多。Python免费学习笔记（深入）：立即使用
在学习笔记中，你将探索 Python 的核心概念和高级技巧！
