COMPOSER_VENDOR_DIR是唯一可靠的vendor路径控制方式，需配合手动更新autoload引用、IDE索引及脚本路径；path类型仓库支持本地实时调试，须正确配置repositories、name和dev版本；PSR-4不允许多路径映射同一命名空间，应辅以classmap。
改 vendor 目录或加本地路径映射，本质是解决“PHP 找不到类”和“开发改了不生效”两个问题；但直接动路径或硬写路径，90% 的失败都源于没同步更新 autoload 入口、IDE 索引或脚本引用。
COMPOSER_VENDOR_DIR 是唯一靠谱的 vendor 路径控制方式
Composer 2.0+ 已彻底移除 config.vendor-dir，你再往 composer.json 里写它，只会收到警告：The "config.vendor-dir" option is deprecated, use the "COMPOSER_VENDOR_DIR" environment variable instead. 并且 vendor 依然装在默认位置。
- Linux/macOS：运行前设变量，
COMPOSER_VENDOR_DIR=third-party composer install - Windows CMD：
set COMPOSER_VENDOR_DIR=third-party && composer install - PowerShell：
$env:COMPOSER_VENDOR_DIR="third-party"; composer install - 路径支持相对（
third-party）或绝对（/var/www/myapp/deps），但避免以/开头的伪绝对路径（如/third-party），Windows 下易解析失败 - 该变量只影响当前命令，不写入配置，适合 CI 或多环境切换
path 类型仓库才是本地包实时调试的正确姿势
很多人试 composer require vendor/name:dev-main 却发现类找不到、改代码没反应——根本原因是没用 type: "path" 仓库，而是误用了 package 或 vcs 类型。path 仓库强制创建符号链接，跳过版本校验，改本地源码立刻生效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 主项目
composer.json根级添加："repositories": [ { "type": "path", "url": "../my-local-package" } ] -
url是相对于主项目composer.json的路径，不是 shell 当前目录 - 本地包必须有合法
composer.json，且name字段（如"acme/utils"）与require中完全一致（大小写、斜杠都不能错） - 版本必须写成开发别名，如
"dev-main"或"dev-develop"；写"*"或"^1.0"会回退到 Packagist - Windows 下需管理员权限或启用开发者模式，否则
vendor/acme/utils是拷贝而非软链，导致修改不生效
autoload 引用和 IDE 索引必须手动同步
COMPOSER_VENDOR_DIR 只控制安装位置，不会自动修复你的 require 'vendor/autoload.php' 或 PHPStorm 的索引路径。类加载失败、断点不触发、IDE 报红，八成是这里漏了。
- 所有硬编码路径都要改：
require 'vendor/autoload.php'→require __DIR__ . '/third-party/autoload.php' -
vendor/bin/phpunit→third-party/bin/phpunit，CI 脚本、Makefile、$PATH里全得扫一遍 - PHPStorm：Settings → PHP → Include Paths → 添加新路径（如
third-party），否则不识别新 vendor 下的类 - 某些框架脚本（如 Laravel 的
artisan）可能内部拼接vendor字符串，得查源码确认是否要 patch -
composer dump-autoload生成的autoload.php是基于当前COMPOSER_VENDOR_DIR值写的，所以必须确保该变量在运行时已设置
多个目录映射同一命名空间？别硬塞 psr-4 数组
PSR-4 规范禁止一个命名空间前缀映射多个路径，你在 composer.json 里写：
"psr-4": { "App": ["src/", "tests/Support/"] } 实际效果是只认最后一个（"tests/Support/"），前面的被覆盖。这不是 Composer bug，是它严格遵循规范。
- 正确做法是混合策略：
psr-4走主逻辑（如"App": "src/"），额外目录走classmap - 在
autoload.classmap里加："App\": ["tests/Support/"]
，Composer 会先查 psr-4，没命中再查 classmap - 修改后必须运行
composer dump-autoload，否则vendor/autoload.php不更新 - 路径值推荐以
/结尾（如"src/"），否则若存在同名文件（src是个文件），Composer 不报错但会找错地方
最常被忽略的点：路径变更后，vendor/autoload.php 是生成时写死路径的入口文件，它不“感知”配置变化；而 Windows/macOS 文件系统默认不区分大小写，但 autoload 映射是大小写敏感的——拼错一个字母，class_exists() 就返回 false。
