composer路径配置需严格区分composer_home（全局配置缓存）、vendor-dir（项目依赖目录）和composer.phar入口位置；改错任一路径将导致命令失效、autoload报错或插件丢失，且须同步更新代码引用、ide索引及ci脚本。
Composer 自定义路径不能“随意调整”，必须分清三个独立路径：COMPOSER_HOME（配置与缓存）、vendor-dir（项目依赖目录）、composer.phar 入口位置——改错一个，命令失效、autoload 报错、全局插件找不到都是常态。
COMPOSER_HOME 改的是配置和全局命令存放地
这个环境变量控制 auth.json、config.json、缓存、以及 composer global require 安装的命令（如 laravel/installer）实际落盘位置。
- Linux/macOS：在
~/.zshrc或~/.bash_profile中加export COMPOSER_HOME="/opt/my-composer"，然后source或新开终端 - Windows PowerShell：
[Environment]::SetEnvironmentVariable("COMPOSER_HOME", "D:my-composer", "User")，重启终端 - 改完后必须手动把旧
~/.composer/下的auth.json（权限设为 600）、config.json复制过去，否则认证丢失或插件不加载 -
composer config --global home只是写进配置文件的值，不生效；真正起作用的是环境变量$COMPOSER_HOME
vendor-dir 改的是项目依赖安装位置
它只在项目根目录的 composer.json 里生效，且必须满足：写在顶层 config 字段、用相对路径（如 "libs"）、删掉旧 vendor/ 后再运行 composer install。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 错误写法：
"vendor-dir": "/libs"（绝对路径）、"vendor-dir": "C:\libs"（Windows 绝对路径）、"vendor-dir": "$HOME/libs"（不展开变量） - 必须同步改代码里的
require 'vendor/autoload.php'→require 'libs/autoload.php' - 如果包声明了
"bin"字段（如phpunit），还得配"bin-dir": "libs/bin"，否则vendor/bin/phpunit软链接断开 -
composer dump-autoload不重建autoload.php入口文件，只刷新类映射 —— 删vendor再重装才是唯一可靠方式
composer 命令本身指向哪，取决于 PATH 和软链接
你敲 composer --version 时，系统找的是 PATH 中某个目录下的可执行文件（通常是软链接），不是 composer.phar 本身。
- 把下载好的
composer.phar放到/opt/composer/composer.phar - 建软链接：
sudo ln -sf /opt/composer/composer.phar /usr/local/bin/composer（Linux/macOS） - Windows 可用
mklink，或直接把composer.phar所在目录加入PATH - 别动 brew/apt 安装的
composer，下次更新会被覆盖；也别用alias composer=...，很多 CI 工具不读 shell alias
installer-paths 和 path 仓库不是通用路径重定向工具
它们有严格触发条件，误配等于白写。
-
extra.installer-paths只对type匹配的包生效（如wordpress-plugin），普通library类型完全无视该配置 -
repositories中的path类型，url必须是相对路径（"./packages/my-utils"），带file://或绝对路径会静默失败 -
COMPOSER_VENDOR_DIR环境变量在 Composer 2.x 中已废弃，设了也无效 - 想让多个项目共用一个 vendor 目录？唯一可行路径是设
COMPOSER_HOME+ 在其config.json里配"vendor-dir"，但这会让所有项目共享依赖，需自行承担冲突风险
最常被忽略的一点：路径改完后，IDE（如 PHPStorm）默认只索引 vendor/，必须手动在 Settings → PHP → Include Paths 中添加新路径；CI 脚本里所有硬编码的 vendor/bin/xxx 也得同步替换，否则流水线必挂。
