根本原因在于composer不读取.env文件，所有平台都需显式传入环境变量：linux/macos用app_env=prod composer install，windows cmd用set app_env=prod && composer install，powershell用$env:app_env="prod"; composer install；ci/cd和docker中必须通过env块、--build-arg或env指令显式注入。
为什么APP_ENV在 Windows 和 Linux 上行为不一致
根本不是系统差异导致的，而是 Composer 脚本执行时根本不读取 .env 文件——无论你在哪台机器上运行 composer install，只要没显式传入变量，$_ENV['APP_ENV'] 就是空的。
常见错误现象："post-install-cmd": "echo $APP_ENV" 在 Linux/macOS 下可能输出值（靠 shell 展开），但在 Windows CMD/PowerShell 中完全不展开；Git Bash 表现又不同，容易误以为“本地能跑 CI 就该行”。
- 所有平台都必须显式传入：
APP_ENV=prod composer install（Linux/macOS）或set APP_ENV=prod && composer install（CMD），PowerShell 用$env:APP_ENV="prod"; composer install - CI/CD 中不能依赖
.env文件自动加载，GitHub Actions、GitLab CI、Jenkins 都需在env块或脚本开头export - Docker 构建阶段若用
RUN composer install，必须在docker build时用--build-arg或在Dockerfile中ENV APP_ENV=prod，RUN 指令本身不继承 shell 环境
composer.json 里哪些字段真能用 ${VAR} 插值
不是所有配置项都支持环境变量插值，误写会导致静默忽略——比如 config.repos 或 scripts 字段里写 ${APP_ENV}，Composer 完全不解析，也不会报错。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 明确支持插值的字段只有：
config.http-basic、repositories[].url、config.process-timeout、config.notify-batch -
repositories[].url必须是 HTTPS 且末尾带/，否则拼接后变成https://mirrors.example.com/packages.json→ 404 -
scripts里的命令字符串本身不解析${VAR}，得靠 shell 层展开，所以"migrate": "APP_ENV=${APP_ENV} php artisan migrate"是错的；应写成"migrate": "php artisan migrate"并由外部传入 - 数值型配置（如
process-timeout）要求变量值为纯数字字符串，COMPOSER_TIMEOUT=300可以，COMPOSER_TIMEOUT="300s"会失败
跨平台镜像源配置为何总在 CI 里失效
镜像源不生效，99% 是因为三个硬性条件没同时满足：repo.packagist 键名必须单数小写、type 值必须显式写 composer、URL 必须 HTTPS 且末尾带 /。漏一个，Composer 就静默回退到 packagist.org。
- Windows 下改完
composer config -g必须重启终端，PowerShell 不重载%APPDATA%\Composer\config.json - Linux/macOS 若用
sudo composer config -g，配置写进 root 家目录，普通用户运行时根本读不到 - 项目级配置更可靠：运行
composer config repo.packagist composer https://mirrors.aliyun.com/composer/（去掉-g），它会直接写进composer.json的repositories对象里 - 务必加
"packagist.org": false到composer.json根节点，否则 Composer 2.2+ 仍可能 fallback
缓存路径迁移后为什么 composer install 还卡在旧源
改了 cache-dir 不等于换了镜像源，缓存目录只影响包下载后的存储位置。真正决定“从哪拉包”的是当前生效的 repositories 配置和 COMPOSER_REPO_PACKAGIST_URL 环境变量。
-
composer clear-cache只清files/、repo/、installers/，但vcs/目录（Git 克隆副本）占空间最大，默认不删，得手动rm -rf ~/.composer/cache/vcs - CI 中若复用旧
composer.lock，它里面记录的是旧源的元数据地址，哪怕你已配好新镜像，Composer 仍会先尝试请求 lock 文件里写的原始 URL - 验证是否真走新源：运行
composer install -vvv 2>&1 | grep "mirrors.aliyun.com"，看到域名才确认；光看composer diagnose输出不够，它只显示配置，不反映实际请求 - 多云环境（如腾讯云 + AWS）下，别在
auth.json里硬编码某云的临时 token，应统一用长期 Basic Auth，并通过密钥管理服务分发
export，或在 Docker command: 里覆盖 entrypoint:，变量根本进不到 composer install 进程里。
