vendor-dir 配置必须写入 composer.json 的 config 对象中才能生效；使用 composer config --local vendor-dir my-vendor 可安全持久化修改，但需同步更新 autoload、scripts 及代码中所有 vendor/ 硬编码路径，且路径须为纯 ASCII、无空格或中文。
vendor-dir 配置必须写在 composer.json 的 config 字段里
直接运行 composer config 命令无法持久化修改 vendor-dir，它只读取当前项目根目录下的 composer.json。这个路径配置属于项目级设置，必须显式写入 JSON 文件的 config 对象中，否则 composer install 或 composer update 仍会使用默认的 vendor/。
实操建议：
- 编辑项目根目录下的
composer.json，确保顶层有"config"键，且其值为对象 - 在
config对象内添加"vendor-dir": "my-vendor"（路径不以斜杠结尾） - 保存后运行
composer install—— 此时才会真正创建my-vendor/目录并安装依赖 - 如果之前已有
vendor/目录，需手动删除，否则 Composer 不会自动迁移或覆盖
用 composer config 命令写入比手改更安全
虽然 composer config 默认操作的是全局配置（~/.composer/config.json），但它支持 --local 标志来精准写入当前项目的 composer.json，避免手误导致 JSON 格式错误。
正确做法是执行：
composer config --local vendor-dir my-vendor
这条命令会自动完成：校验 composer.json 可写性、解析 JSON、插入/更新 config.vendor-dir、格式化并保存。比手动编辑少出错，尤其适合 CI 脚本或多人协作场景。
注意：--local 不可省略；漏掉会导致配置被写进全局文件，对当前项目无效。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
自定义 vendor-dir 后，autoload 和脚本路径要同步调整
Composer 不会自动重写 autoload 的 psr-4 映射或 scripts 中的路径引用。比如你的 composer.json 原本有：
"autoload": { "psr-4": { "App\": "src/" } },<br>"scripts": { "post-install-cmd": "php vendor/bin/some-tool" }
改成 vendor-dir 为 lib 后，post-install-cmd 中的 vendor/bin/some-tool 就会失败——实际路径已变成 lib/bin/some-tool。
需要同步检查并修正：
-
scripts里所有含vendor/的硬编码路径 - PHP 代码中通过
__DIR__ . '/vendor/autoload.php'加载 autoloader 的地方（应改用require_once __DIR__ . '/lib/autoload.php'） - 某些依赖包的插件机制（如 PHPUnit 的
phpunit.xml中的bootstrap路径）也可能受影响
Windows 下路径分隔符和权限问题更易暴露
在 Windows 上设 vendor-dir 为类似 deps 或 pkgs 这类短名没问题，但若用带空格或中文的路径（如 第三方依赖），composer install 会直接报错：Could not create directory "D:project第三方依赖" —— 并非权限问题，而是 Composer 内部部分逻辑未正确转义空格和 Unicode 字符。
稳妥做法：
- 始终用纯 ASCII 字母数字命名，如
vendor-local、ext-lib - 避免以点开头（如
.vendor），某些 Git 忽略规则或 IDE 会跳过该目录 - CI 环境中若用 Docker，宿主机与容器内路径映射不一致时，
vendor-dir值最好与宿主机保持一致，否则 autoload 生成的 classmap 可能指向错误位置
这个配置看着简单，但一旦涉及跨平台、自动化构建或已有项目迁移，路径引用散落在各处，漏改一处就可能让整个 autoload 失效，得逐个 grep 确认。
