PSR-4映射必须以双反斜杠结尾，如"App\Http\Controllers\"，路径需大小写敏感且与命名空间严格对齐，修改composer.json后须执行composer dump-autoload生效。
PSR-4 映射必须用反斜杠结尾，否则子目录结构不生效
“AppHttpControllers” 这样的子命名空间前缀，必须在 composer.json 中写成 "App\Http\Controllers\"（JSON 里双写反斜杠），否则 Composer 会当成 PSR-0 或直接忽略。写成 "AppHttpControllers"（少一个反斜杠）或 "AppHttpControllers"（没转义）都会导致 class AppHttpControllersHomeController 找不到对应文件。
常见错误现象：Class 'AppHttpControllersHomeController' not found，但文件明明在 src/Http/Controllers/HomeController.php。
- 命名空间键必须以双反斜杠结尾：
"App\Http\Controllers\"✅，"AppHttpControllers"❌ - 路径值需与命名空间后缀严格对齐：前缀
"App\Http\Controllers\"对应目录"src/Http/Controllers/"，不是"src/http/controllers/"（大小写敏感） - 不能为子命名空间单独设映射：比如已配了
"App\" => "src/"，就别再加"App\Http\" => "src/Http/"——后者会被前者覆盖，且违反“最长前缀优先”规则
子目录层级必须和剩余命名空间段完全一致
Composer 不扫描目录，它只做字符串替换：把类名 AppHttpControllersHomeController 去掉前缀 App\，剩下 HttpControllersHomeController，再把反斜杠换成斜杠，拼上配置的路径 src/，得到 src/Http/Controllers/HomeController.php。错一个环节，文件就加载失败。
使用场景：你希望 AppServicesPaymentStripeClient 加载自 src/Services/Payment/StripeClient.php。
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 命名空间声明必须是
namespace AppServicesPayment;，不能漏段或顺序颠倒 - 文件路径必须是
src/Services/Payment/StripeClient.php，不能是src/services/payment/StripeClient.php（Linux/macOS 下直接 404） - 类名必须严格等于文件名：
class StripeClient→ 文件名必须是StripeClient.php，大小写、扩展名都不能错
修改 composer.json 后不运行 dump-autoload = 白配
vendor/autoload.php 不读 composer.json，它只加载 vendor/composer/autoload_psr4.php 这个生成文件。你改完配置不执行命令，Composer 根本不知道你写了啥。
性能影响：开发中建议始终加 -o 参数，即运行 composer dump-autoload -o。不加时，每次自动加载都要运行时拼路径、检查文件是否存在；加了之后，所有映射提前固化进数组，加载更快、更稳定。
- CI/CD 部署必须用
composer install --no-dev --optimize-autoloader，避免本地未提交的 autoload 文件污染线上 - 验证是否生效：直接
var_dump(include 'vendor/composer/autoload_psr4.php');，看输出数组里有没有你配的"App\Http\Controllers\" => ["src/Http/Controllers/"] - 报错仍存在？先运行
composer show --platform确认当前 autoloader 是否已更新
跨项目目录映射的边界限制
PSR-4 路径必须是相对 composer.json 所在位置的路径，且不能跨文件系统。想把 ../shared-utils/src/ 映射到 SharedUtils 可以，但 /var/www/shared/src/ 就不行——Composer 会报 Invalid path。
容易踩的坑：路径开头带 /（如 "/src/"）会被当绝对路径忽略；路径末尾不加 /（如 "src"）在某些版本会警告或与同名文件冲突。
- 正确写法：
"SharedUtils\" => "../shared-utils/src/"✅ - 错误写法：
"SharedUtils\" => "/var/shared/src/"❌（绝对路径） - 错误写法：
"SharedUtils\" => "src"❌（缺末尾斜杠，易歧义）
composer.json 配置这三者之间严丝合缝的要求——差一个反斜杠、一个大小写、一个斜杠，Class not found 就立刻报给你，没有模糊地带。 
