PSR-4映射是静态快照，需手动执行composer dump-autoload更新；常驻进程须清空并重载autoload，classmap仅在-dump-autoload -o时生效，autoload-dev配置错误会导致测试类泄露至生产环境，path包需正确配置symlink且验证链接有效性。
PSR-4映射不会随文件改动自动更新
Composer生成的autoload映射（如vendor/composer/autoload_psr4.php）是静态快照，只在composer dump-autoload时生成一次。Swoole或RoadRunner等常驻进程模型下，哪怕你改了src/Service/User.php的命名空间为AppServicesUser，旧映射仍保留在内存里，new AppServicesUser会直接报Class not found。
这不是PHP缓存，而是$loader->prefixesPsr4数组没被重置。热重载工具（如swoole/watcher或inotifywait + php脚本）必须显式触发重载逻辑：
- 监听
src/和composer.json变更后，执行composer dump-autoload -o - 在Swoole的
onWorkerStart回调中调用$loader->setPsr4([])清空旧映射，再重新require vendor/autoload.php - 避免在
onReceive或HTTP handler里动态require_once——这绕过Composer，且易引发重复定义
classmap与PSR-4混用导致“两头不靠”
你在composer.json里同时配了"psr-4": {"App\": "src/"}和"classmap": ["src/Utils.php"]，但Utils.php没声明namespace App;。结果：PSR-4规则跳过它（因无匹配命名空间），classmap又因未执行dump-autoload -o而未生效，文件彻底加载失败。
关键判断点：
-
classmap只对composer dump-autoload -o生效；不加-o，它根本不会写入autoload_classmap.php - 同一类名不能跨两种规则注册，否则行为未定义（Composer通常以PSR-4优先）
- 高频调用的工具类（如
Str::）更适合用classmap，省去命名空间解析开销
autoload-dev里的测试类意外进入生产环境
你把"autoload-dev": {"psr-4": {"Tests": "tests/"}}写进了composer.json，但键名拼错成autoloadDev（缺连字符）或缩进嵌套在require-dev里。Composer静默忽略该配置，转而把Tests映射塞进主autoload通道——导致composer install --no-dev后，vendor/autoload.php里仍有Tests前缀，线上报Class TestsUnitExampleTest not found。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
验证是否生效：
- 运行
composer dump-autoload --dev（注意--dev参数，不加就白配） - 检查
vendor/composer/autoload_psr4.php是否含"Tests\"键；若存在，说明没加--no-dev或配置位置错了 - CI脚本里用
composer install --no-dev前，先跑composer validate确认JSON结构合法
本地Path包热调试时symlink失效
你用"repositories": [{"type": "path", "url": "../my-pkg"}]引入本地包，改完my-pkg/src/Helper.php却没生效。大概率是Composer fallback到了copy模式——因为../my-pkg目录下没有git init或没提交，或者Windows下没用管理员权限运行终端，mklink失败且无提示。
真链接必须满足：
-
my-pkg/composer.json里明确写"options": {"symlink": true}（不是主项目里配） -
ls -la vendor/vendor-name/my-pkg输出带->箭头（Linux/macOS）或JUNCTION字样（Windows） - IDE调试路径必须和磁盘真实路径完全一致，否则Xdebug断点打不进
热重载时最容易被忽略的是：Swoole的max_request或reload_async触发Worker重启，并不会重建$loader实例——它还是启动那一刻的映射。任何依赖运行时修改autoload的行为（比如动态addPsr4）都不可靠。
