Composer脚本执行时不自动加载项目类，需手动引入vendor/autoload.php；必须正确配置composer.json中的autoload（如"psr-4"映射），并运行composer dump-autoload；依赖类需手动实例化或显式构建DI容器。
Composer脚本里直接 new 类会报错？
不是类找不到，是 autoloader 还没加载进来——composer.json 里定义的脚本执行时，Composer 默认不自动引入项目 autoload。你写 new App\SomeService()，PHP 真的不认识这个命名空间。
实操建议：
- 必须在脚本入口手动 require
vendor/autoload.php，哪怕只有一行 - 推荐把脚本写成独立 PHP 文件（如
scripts/deploy.php），而不是内联 JSON 字符串，可读性和调试性高得多 - 别在
"scripts": { "foo": "php -r 'new App\X();'" }这种写法里硬塞逻辑——-r没有自动加载，也难加断点
如何让 Composer 脚本正确识别你的类路径？
关键不在脚本本身，而在 composer.json 的 autoload 配置是否生效。Composer 脚本运行时用的是项目根目录下的 autoload，不是 vendor 里的那个“基础”加载器。
常见错误现象：
立即学习“PHP免费学习笔记（深入）”；
- 类存在、路径没错，但提示
Class 'App\Helper' not found -
composer dump-autoload后仍无效 → 很可能autoload段没配"psr-4"或配错了前缀/路径映射
检查点：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
-
"autoload": { "psr-4": { "App\": "src/" } }—— 注意末尾斜杠和命名空间结尾反斜杠必须一致 - 改完
composer.json后，一定跑一次composer dump-autoload - 如果类在
tests/下，且想在脚本中用，得额外加"autoload-dev"并确保脚本执行时 dev autoload 生效（默认是生效的）
调用带依赖的类方法时，容器没启动怎么办？
Composer 脚本不是 Laravel 或 Symfony 应用上下文，$app、$container 这些全局对象根本不存在。你想调 MyCommand::handle()，它内部依赖 LoggerInterface，那就要自己 resolve。
实操建议：
- 最轻量做法：手动 new 依赖项，再传进去（适合简单场景）
- 若项目已用 DI 容器（如 Symfony DI），可在脚本里显式构建容器：
$container = require 'config/bootstrap.php';，但注意 bootstrap 文件得导出容器实例 - 避免在脚本里重复初始化数据库连接、缓存等重资源——脚本应尽量短平快，复杂逻辑抽到命令行命令里更合适
为什么有些类在脚本里能 new，有些却提示找不到？
本质是 classmap 和 PSR-4 的差异。Composer 对 classmap 是“扫描即注册”，而 PSR-4 是“按命名空间+路径规则动态定位”。如果你的类没走 PSR-4 规则（比如放在 lib/ 下但没配 autoload），或者用了全局函数式写法（function my_util() {}），那脚本里就只能靠 require_once 显式加载。
排查步骤：
- 运行
composer show --platform确认 PHP 版本兼容性（尤其用了新语法的类） - 用
composer dump-autoload -o生成优化后 classmap，某些非标准路径的类反而能被扫到 - 临时加一行
var_dump(class_exists('App\SomeClass'));到脚本开头，确认是不是 autoload 问题，还是真没生成类定义
容易被忽略的一点：脚本执行用户可能和 Web 服务器用户不同，导致 opcache 或权限问题影响类加载，本地测试通过不等于上线一定行。
