require不生效主因是name和路径未逐字匹配：name须大小写、短横线、vendor前缀完全一致；url须指向含合法composer.json的目录且无尾斜杠；改autoload需执行composer update而非dump-autoload；symlink需配置"symlinks": true并确保权限与系统支持。
path仓库require不生效：name和路径必须逐字匹配
Composer读取path仓库时不做任何容错或模糊匹配，name字段必须和require中写的字符串完全一致——包括大小写、短横线-位置、vendor前缀，一个字符都不能差。比如本地包composer.json里写的是"name": "acme/http-client"，主项目require里就不能写"acme/http_client"或"Acme/HttpClient"。
路径url也必须指向真实存在的目录，且该目录下必须有合法的composer.json（无语法错误、含name和version）。常见错误：
-
url末尾多了斜杠："../my-pkg/"会被静默忽略，应写成"../my-pkg" - 用了
~或$HOME：Composer明确拒绝，必须用绝对路径或纯相对路径 - Linux/macOS下大小写敏感：
MyPkg≠mypkg，ls -ld ../mypkg能立刻暴露问题
autoload不更新：dump-autoload对path仓库无效
composer dump-autoload只重生成主项目的自动加载映射，它不会重新读取path仓库里包的composer.json中的autoload配置。那些规则早在composer install或composer update时就被静态写死进vendor/composer/autoload_psr4.php了。
改了path包里的命名空间或src/结构后，必须在主项目根目录运行：
-
composer update acme/http-client（不是dump-autoload） - 然后检查
vendor/composer/autoload_psr4.php，搜索"Acme\Http\"，确认映射的是你本地的绝对路径，不是vendor下的副本 - 如果path包的
composer.json没提交（git未add），update会读旧配置，白忙一场
symlink没生效：权限、系统限制或配置嵌套错误
path仓库默认尝试软链接，但一旦失败（Windows权限不足、Docker挂载不支持、NTFS符号链接未启用），Composer会静默回退到复制模式——你改本地代码，vendor/里仍是旧副本，调试时毫无感知。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
确保repositories配置中"symlinks": true是直接写在path条目内，不是放在顶层或config里：
{
"repositories": [
{
"type": "path",
"url": "../my-pkg",
"symlinks": true
}
]
}
注意版本兼容性："options": {"symlink": true}是旧写法，Composer 2.2+ 必须用"symlinks": true；混用会静默失效。Windows用户还需确认已以管理员身份运行终端并启用开发者模式。
缓存和环境变量干扰：路径看似正确却走错地方
即使所有配置都对，Composer仍可能因缓存或环境变量走偏。比如COMPOSER_HOME指向了/root/.composer，你改的其实是root用户的配置，而当前shell用的是普通用户；又或者COMPOSER_CACHE_DIR设了但COMPOSER_HOME本身含中文或空格，导致整个全局配置fallback到默认路径。
排查步骤：
- 运行
composer config --global --list --verbose，看Loaded config file:路径是否是你预期的位置 - 执行
echo $COMPOSER_HOME（Linux/macOS）或echo %COMPOSER_HOME%（Windows），输出必须是纯英文、无空格、绝对路径 - 临时清掉干扰：
unset COMPOSER_HOME（Linux/macOS）或set COMPOSER_HOME=（Windows），再新开终端重试
真正生效的从来不是“我以为我配好了”，而是composer config --global cache-dir输出的路径，以及ls -l能真实列出的那个目录。
