子命名空间映射必须用psr-4且路径对齐命名空间层级，如"app\": "src/"，而非为子命名空间单独映射；反斜杠需双写，映射前缀不可互相包含，修改后须执行composer dump-autoload验证。

Composer 的子命名空间映射必须写在 autoload 或 autoload-dev 的 psr-4（或 psr-0）下，不能用 classmap 实现精确到子命名空间的自动加载 —— 否则类找不到，且错误提示极其模糊。

子命名空间映射必须用 psr-4，且路径要对齐命名空间层级

PSR-4 要求目录结构与命名空间后缀严格对应。比如你想让 AppServicesPaymentAlipay 加载自 src/Services/Payment/Alipay/，就必须把整个 AppServices 映射到 src/，而不是单独为 AppServicesPaymentAlipay 写一条映射。

• ✅ 正确写法（在 composer.json 中）：

  "autoload": {
    "psr-4": {
      "App\": "src/"
    }
  }

  然后确保 src/Services/Payment/Alipay/Client.php 里声明 namespace AppServicesPaymentAlipay;
• ❌ 错误写法：

  "App\Services\Payment\Alipay\": "src/Services/Payment/Alipay/"

  这会导致 Composer 认为命名空间前缀是 AppServicesPaymentAlipay，而文件里写的却是 AppServicesPaymentAlipayClient，尾部多了一级，自动加载失败
• ⚠️ 注意反斜杠必须双写（\），JSON 里单个 是非法转义

多个子命名空间共存时，映射顺序不重要，但前缀不能互相包含

Composer 会逐个匹配最长前缀，所以 "AppConsole": "src/Console/" 和 "App": "src/" 可以共存，但反过来写（先写 "App": "src/"）也没问题 —— 因为匹配基于命名空间字符串长度，不是配置顺序。

Discussion Composer

围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par

下载

• ✅ 安全组合：

  "App\Console\": "src/Console/",
  "App\Http\Controllers\": "src/Http/Controllers/",
  "App\": "src/"

• ❌ 危险组合：

  "App\": "src/",
  "App\Models\": "app/Models/"

  —— 这会导致所有 AppModels* 类优先走 src/ 下查找，根本不会进 app/Models/，除非 src/ 里真有对应路径
• ? 提示：开发阶段可运行 composer dump-autoload -o 后检查 vendor/composer/autoload_psr4.php，确认生成的映射数组是否符合预期

测试子命名空间是否生效，别只看 composer install 是否成功

安装成功不代表自动加载通了。常见假阳性：类文件存在、命名空间拼写正确、composer.json 修改后忘了 dump-autoload，结果运行时报 Class not found 却查不出原因。

• ✅ 快速验证方式：

  php -r "var_dump(class_exists('AppServicesPaymentAlipayClient'));"

  返回 bool(true) 才算真正可用
• ⚠️ 常见干扰项：autoload-dev 里的映射默认不参与生产环境加载，如果在 tests/ 里定义了 TestHelpers\ 映射，但你在 public/index.php 里尝试 new 它，就会失败
• ? 调试技巧：临时加一句 echo debug_print_backtrace(DEBUG_BACKTRACE_IGNORE_ARGS); 在疑似加载失败的类文件头部，看是否被 include

最易忽略的是命名空间末尾的反斜杠 —— "App\" 是合法前缀，"App" 会破坏 JSON 格式；还有就是改完 composer.json 后习惯性只跑 install，却跳过了 dump-autoload 这一步。