Composer全局镜像配置常因键名错误（如repos.packagist）、缺type值、URL末尾无/或项目级repositories字段屏蔽而静默失效；项目级配置更可靠，需在项目根目录执行composer config repo.packagist composer https://mirrors.aliyun.com/composer/。
国内用 Composer 不配镜像源，根本装不完——不是慢，是卡死在 TLS 握手、DNS 解析或 403 错误上；多个项目共用 vendor 或 composer.json，必然冲突，Composer 没有“多版本并存”机制，所谓隔离全是靠你手动控制路径、加载时机和约束范围。
composer config -g repo.packagist 命令为什么总不生效
这条命令写错一个字符就静默失效，且不报错。常见错误包括：
-
repo.packagist写成repos.packagist（多一个 s），Composer 完全忽略该字段 - 漏掉
-g参数，结果只改当前项目composer.json，换目录就失效 - URL 少了末尾斜杠，比如写成
https://mirrors.aliyun.com/composer，请求会拼成/composerpackages.json导致 404 - 省略
composer这个 type 值，Composer 2.0+ 会 fallback 到packagist.org
验证是否成功：运行 composer config -g repo.packagist，输出必须是类似 {"type": "composer", "url": "https://mirrors.aliyun.com/composer/"} 的 JSON 对象。空、null、报错或旧地址，都说明没配对。
项目级镜像配置比全局更可靠
全局配置在宝塔、CI 或多用户环境下极易失效，因为执行命令的用户（如 www 或 runner）和配置用户（如 root）不一致。项目级配置可被 Git 跟踪，且不会被覆盖：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 进项目根目录，运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g） - 它会自动在
composer.json顶层写入"repositories"字段，key 固定为"packagist" - 如果项目已有
"repositories"字段，确保它是对象结构（不是数组），否则命令可能误删私有源
注意："packagist.org": false 这类写法会直接屏蔽全局镜像，但项目级配置不受影响。
vendor 目录必须严格按项目隔离
多个项目共用 vendor/ 或通过软链接共享，会导致 Class not found、autoload 映射错乱、CI 构建失败。关键控制点：
- 每个项目必须有自己的
composer.json和独立根目录，禁止在父目录（如/var/www/）下运行任何composer命令 - 禁用
COMPOSER_VENDOR_DIR环境变量或全局config设置，避免跨项目写入 - Docker 构建时，不要
COPY vendor/，而应在容器内执行composer install --no-dev --optimize-autoloader --classmap-authoritative --no-interaction - 子项目（如 subtree）需在自身目录运行
composer install --no-autoloader --no-scripts，并显式设置"vendor-dir"和psr-4autoload
生产环境依赖隔离不能只靠 --no-dev
--no-dev 只跳过安装 require-dev 包，但不会清理已生成的 autoload 映射、composer.lock 中的 dev 记录，也不会删除 vendor/bin/ 或 tests/ 目录：
- 检查
composer.lock：运行grep -A5 '"packages-dev"' composer.lock | head -20，非空即风险 - 补救必须加
composer dump-autoload --no-dev，否则vendor/autoload.php仍含tests/映射 - Docker 构建后应清理残留：
find vendor -name 'tests' -o -name 'Tests' -o -name 'bin' -o -name '.git' | xargs rm -rf - CI 流水线中，构建前务必先跑
composer update --no-dev --lock，生成不含 dev 包的新composer.lock
真正起作用的不是开关，而是每一步是否被严格执行——尤其 composer install 后的清理动作，最容易被跳过，也最常引发线上故障。
