根本原因是命令必须严格满足四个硬性条件：键名必须为repo.packagist（单数、无s）、第三个参数composer是必需type值、url须https且末尾带/、必须加-g，缺一则静默失效；验证需执行composer config -g repo.packagist，正确输出应为{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}。
composer config -g repo.packagist 命令总不生效
根本原因不是命令写错，而是四个硬性条件缺一不可：拼写必须是 repo.packagist（不能多 s、不能写成 packagist.org），第三个参数 composer 是 type 值（不是注释），URL 必须以 / 结尾，且必须带 -g。漏掉任意一个，Composer 就静默忽略整条配置。
验证是否写入成功，直接运行：composer config -g repo.packagist
正确输出应为类似：{"type": "composer", "url": "https://mirrors.aliyun.com/composer/"}
如果返回空、null 或报错，说明没写对。
常见误操作包括：
- 把
composer config -g repo.packagist composer https://mirrors.aliyun.com/composer少写了末尾/→ 请求变成.../composerpackages.json，404 - 在项目目录下执行没加
-g→ 写进当前项目的composer.json，换个项目就失效 - CI/CD 中用
sudo composer config -g→ 配置写进了root用户的COMPOSER_HOME，但构建进程以www-data运行，根本读不到
明明配了镜像却还是连 packagist.org
不是配置没保存，而是被更高优先级的设置覆盖了。Composer 的源优先级是：项目级 repositories > 全局配置 > 默认源。只要项目根目录下的 composer.json 里有 "repositories" 字段（哪怕只写 {} 或 []），全局镜像就完全失效。
排查步骤：
- 进项目目录后运行
composer config repo.packagist，看是否输出 URL - 检查
composer.json是否含"repositories"键；有则删掉，或显式改写为"packagist.org": false后再加镜像 - 最准验证方式：加
-vvv跑一次安装：composer install -vvv 2>&1 | grep -i "mirrors\|packagist"，看实际请求的 host 是不是你设的镜像域名
Windows 下中文路径导致 install 失败
这不是 Composer 配置能绕开的问题，而是 PHP 底层函数（realpath()、scandir()、opendir()）在 Windows 上对非 ASCII 路径解析直接失败。终端代码页是 GBK，PHP 内部按 UTF-8 处理字节流，路径语义当场断裂。
典型报错包括：Invalid argument、failed to open stream、realpath() returned false。哪怕路径只是 C:\Users\张三\myapp 或 D:\test@v1，都可能触发。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
临时验证方法极简单：
- 把项目复制到纯英文短路径下，例如
C:\p\myapp - 关掉所有旧终端（CMD/PowerShell/Git Bash），新开一个
-
cd /d C:\p\myapp，再运行composer install - 若成功，100% 是原路径中文/非法字符导致；失败则另查其他原因
注意：composer.json 里的 name 和 autoload.psr-4 字段也不能含中文或非法字符，否则 dump-autoload 会静默跳过或直接崩，错误信息却不指明具体哪一行。
全局 bin 目录找不到命令
执行 composer global require laravel/installer 后，laravel 命令仍提示 command not found，90% 是因为没把 Composer 全局 bin 目录加进 PATH，或者加错了路径。
新版 Composer（2.4+）默认把全局可执行文件放在：
Linux/macOS：~/.config/composer/vendor/bin
Windows：%APPDATA%\Composer\vendor\bin
但这个路径可能被自定义过，不能硬猜。
唯一可靠方式是运行：composer global config bin-dir --absolute
它输出的才是真实路径，比如：/home/alice/.config/composer/vendor/bin 或 C:\Users\Alice\AppData\Roaming\Composer\vendor\bin
然后：
- Linux/macOS：编辑对应 shell 配置文件（
~/.zshrc或~/.bash_profile），加一行：export PATH="$(composer global config bin-dir --absolute):$PATH"
改完必须source ~/.zshrc或新开终端 - Windows：在「系统属性 → 环境变量」中，把输出路径加进「用户变量」的
Path，**不要加尾部反斜杠**，加完重启所有终端（包括 VS Code）
最后验证：echo $PATH | grep -o "/.*composer.*bin"（Linux/macOS）
或 where laravel（Windows）
