换源不能解决Resolving dependencies卡顿，根本原因是Composer仍fallback查packagist.org；需在composer.json根级设"packagist.org": false、私有源URL末尾加/、精简lock文件、启用--classmap-authoritative并规范PSR-4路径。
换源不能解决导出慢，composer install 卡在 Resolving dependencies 或 Generating autoload files 阶段，说明问题根本不在下载——而是依赖解析与自动加载重建耗时。导出加速的关键是锁文件精简、autoload 策略切换和私有源显式隔离。
为什么 composer install 导出仍卡在 resolving 阶段？
这不是网络问题，是 Composer 在反复 fallback 查 packagist.org。即使你配了阿里云镜像，只要没关掉公共源，它仍会为每个私有包去官方源探测一次，尤其当项目含 50+ 私有包时，解析时间指数级增长。
-
"packagist.org": false必须写在composer.json根级，漏掉就白配镜像 - 私有仓库 URL 末尾缺
/（如https://artifactory.example.com/repovshttps://artifactory.example.com/repo/），会被识别为两个不同源，触发冗余探测 - 若用 Artifactory 或 Nexus，后端仓库类型必须是
type: composer，Generic类型不提供packages.json接口，Composer 会静默 fallback
如何让 composer install 真正跳过解析、直奔安装？
靠 composer.lock 文件的完整性与最小化。大型项目 lock 文件超 10MB 后，JSON 解析本身就要 2–3 秒，且包含大量已废弃的 require-dev 包残留字段，徒增开销。
- 定期运行
composer update --lock（不带包名），压缩 lock 文件体积，实测可从 12MB 降至 3MB，解析耗时下降 60%+ - 删掉 lock 文件中已移除的 dev 包条目：搜索
"name": "phpunit/phpunit"等不再 require 的包，手动清理整块 JSON - 私有包的
composer.json中加"archive": {"exclude": ["/tests", "/docs", "/examples"]}，避免 Satis 构建时把无关路径哈希写入 lock
--optimize-autoloader 和 --classmap-authoritative 怎么配才不报错？
这两个参数不是“越快越好”，而是强约束组合：启用 --classmap-authoritative 后，autoloader 彻底禁用 file_exists() 检查，只查 vendor/composer/autoload_classmap.php —— 漏一个类，就 Class not found。
- 确保 PSR-4 命名空间路径末尾带
/，例如"App": "app/"✅，写成"App": "app"❌ 就不会被扫描进 classmap - 检查类文件内
namespace是否拼错，比如namespace AppConsoleCommands;（缺\）会导致类名无法匹配，进不了 classmap - 不要把
tests/目录塞进autoload或autoload-dev，否则它们不会被扫描，但运行时硬引用就会崩 - 验证方式：打开
vendor/composer/autoload_classmap.php，搜索完整类名（如AppConsoleCommandsDeployCommand），确认存在
CI/CD 中导出失败，auth.json 为什么不起作用？
因为 auth.json 只对 composer 类型源有效；如果是 vcs 类型（如 git@ 或 HTTPS + PAT），Composer 根本不读它。
- SSH 方式下，必须走系统 SSH agent，或在
~/.ssh/config中配好Host别名并启用ForwardAgent yes - HTTPS + PAT 方式下，token 权限必须含
read_package_registry（GitLab）或repo（GitHub），且 URL 要写成https://oauth2:@gitlab.com/org/private.git - 宝塔、Docker 或 GitHub Actions 中，全局配置常因用户权限错位失效（如 root 配的
~/.composer/config.json，但构建用www-data用户运行），优先用项目级composer config repo.packagist ...配置
导出快不快，80% 取决于 lock 文件是否干净、autoload 是否权威、私有源是否真正隔离——镜像只是第一层，后面三步漏一步，install 就永远卡在“正在生成 autoload”那行不动。
