composer config -g repo.packagist 没生效的根本原因是未满足三个硬性条件：必须带-g参数写入全局配置、type值显式指定为composer、url末尾必须带/，且验证输出须为完整json或有效url，空、null或仍为packagist.org即失败。
composer config -g repo.packagist 为什么没生效？
很多团队改完配置，composer install还是卡在 Resolving dependencies，根本原因是命令没跑对或没跑全。不是“改了就行”，而是必须满足三个硬条件：
-
composer config -g repo.packagist必须带-g（global），项目级的composer config repo.packagist在 CI/CD 构建机上基本无效 - type 值必须是
composer，不能省略，否则 Composer 当成普通 HTTP 源处理，后续 dist 下载会失败 - URL 必须以
/结尾，比如https://pkgs.internal/✅，写成https://pkgs.internal❌，会导致拼出https://pkgs.internalpackages.json这种 404 路径
执行后立刻验证：composer config -g repo.packagist 输出应为完整 URL 或 JSON 对象，空、null、或仍是 {"type": "composer", "url": "https://repo.packagist.org"} 都说明没生效。
Satis 静态镜像返回 404 或 “file could not be downloaded” 怎么排？
这不是网络不通，是服务端响应不合规 —— Satis 生成的是纯静态文件，全靠 Web 服务器正确透出。Nginx/Apache 必须满足三件事：
- 显式声明 MIME 类型：
types { application/json json; }，否则返回text/plain，Composer 直接拒收packages.json -
dist/目录下的 ZIP 文件路径要能直接 GET，例如https://pkgs.internal/dist/vendor/package/version-hash.zip；检查 SELinux 是否启用、文件权限是否为644、Nginx 的root是否指向 Satis 构建输出目录（如web/） - 构建命令漏掉输出目录是高频错误：
php bin/satis build satis.json dist，少写dist就会把文件生成到当前目录，Web 服务根本找不到
私有包始终 “Could not find package xxx” 是哪出问题？
Satis 不代理请求，也不自动同步你没明说的包。它只按 satis.json 里写的规则拉取，不会猜你要什么。常见错因有三个：
-
"require-all": true和"require": {}绝对不能混用，Satis 会静默跳过部分包，下游报错却完全不提示冲突 - 私有 Git 仓库必须在
repositories数组中完整定义，"type": "vcs"+"url"缺一不可，不能只写字符串 URL - 如果用了
"require-all": true，但某个私有包的composer.json里声明了依赖外部包（如psr/log），而该外部包未被 Satis 显式包含，就会找不到 —— Satis 不递归解析依赖，只扫你列出的源
内网用 file:/// 协议镜像要注意什么？
本地文件系统镜像适合开发测试或离线环境，但细节极易踩坑：
- URL 必须是三个斜杠：
file:///data/packagist✅，少一个就是file://data/packagist→ 404 - HTTP 地址默认被拒绝，除非加
--allow-http参数，但内网 HTTPS 更稳妥 - 如果内网 HTTPS 镜像证书不可信，先关校验：
composer config -g secure-http false，别让 TLS 拦在第一步
真正难的不是搭起来，而是让 packages.json 的元数据和 dist/ 下 ZIP 的路径、权限、MIME、URL 结构全部对齐 —— 差一个字符、少一个头、多一个斜杠，Composer 就静默失败，连错误提示都不给你。
php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！
