必须同步修改composer.json中psr-4映射，如将旧的"app": "app/"改为"appcontrollers": "app/controllers/"，并执行composer dump-autoload -o，否则路径不匹配导致class not found。
autoload.psr-4 映射必须按新框架命名空间重写
旧项目用 AppHttpControllers，新框架要求 AppControllers，光改类文件名和命名空间不够——composer.json 中的 psr-4 映射必须同步调整。否则 composer dump-autoload 生成的映射表里根本找不到新路径，运行时直接 Class not found。
常见错误是把 "App\": "app/" 留着不动，以为“反正都在 app/ 下”。但新框架的控制器实际放在 app/Controllers/，而旧映射会尝试加载 app/Http/Controllers/UserController.php，路径对不上。
- 先确认新框架的命名空间规范（如 Laravel 10 要求
AppControllers对应app/Controllers/） - 在
composer.json中删掉旧映射，新增对应项："App\Controllers\": "app/Controllers/" - 确保目录结构与命名空间严格一致：类
AppControllersUserController必须存在于app/Controllers/UserController.php，大小写不能错 - 改完立刻执行
composer dump-autoload -o，否则 PHP 不会读取新配置
用 classmap + files 混合加载解决无命名空间的老代码
有些迁移模块是纯函数库或没有命名空间的类，比如 helpers.php 或 LegacyService.php，PSR-4 压根不适用。硬塞进 PSR-4 会导致路径错乱、加载失败，甚至重复定义函数。
正确做法是分层处理：classmap 扫描老代码目录生成静态映射，files 自动引入全局函数文件。两者不能混用——files 会在每次 autoload 时无条件 require，滥用会拖慢性能。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 对老类文件（如
lib/Legacy/下所有*.php），加到classmap："classmap": ["lib/Legacy/"] - 对纯函数文件（如
app/helpers.php），只放进files："files": ["app/helpers.php"] - 执行
composer dump-autoload -o后，classmap内容写入vendor/composer/autoload_classmap.php，files列表写入autoload_files.php - 检查是否残留旧的
require 'lib/xxx.php'—— 这些必须全部删除，否则和 autoload 冲突，触发Fatal error: Cannot redeclare
replace + require 组合绕过框架核心包版本冲突
Laravel 8 项目要接入 Laravel 10 的 laravel/serializable-closure，但它的依赖 illuminate/support:^10.0 和当前 ^8.0 直接冲突，composer update 会报错退出。
这不是“装两个版本”，而是用 replace 告诉 Composer：“我已经提供了兼容实现”，再用 require 显式锁定你实际能跑的版本。跳过冲突检测，但不解决运行时兼容性问题。
-
replace的包名必须完全一致（包括大小写），版本写*："replace": {"laravel/serializable-closure": "*"} - 紧接着在
require里指定你真正要装的版本："laravel/serializable-closure": "^1.3" - 该技巧仅让
composer install通过，不保证功能等价——如果新包用了match表达式（PHP 8.0+），而你还在 PHP 7.4 环境，运行时照样崩 - 别对核心框架包（如
laravel/framework）滥用replace，它会破坏整个依赖图，导致其他包无法解析
蓝绿发布中 autoload.php 不能现场生成
切流前绿环境必须已准备好完整 vendor/ 和优化后的 autoload.php。如果在生产机上现场跑 composer install，会触发 vendor/composer/autoload_static.php 重建，同时可能加载错误版本的扩展（如 ext-redis ABI 不匹配），导致切流瞬间大量 500。
CI 构建阶段才是唯一可信入口。任何“先上线再装依赖”的操作，本质上是在赌 PHP 运行时状态不变——而它从来都不稳定。
- 构建命令必须带全参数：
composer install --no-dev --prefer-dist --optimize-autoloader --apcu-autoloader -
composer.lock必须由 CI 机器生成并提交，本地开发机生成的锁文件可能因ext-intl是否启用导致解析差异 - 验证环节加一行：
php -r "require 'vendor/autoload.php'; echo 'autoload OK';"，确保生成的映射能被 PHP 正确加载 - 别忽略
COMPOSER_PLATFORM_CHECK=0的副作用——它跳过平台检查，但不会让缺失的ext-mbstring变出来，运行时仍会报Class 'MbString' not found
