Composer脚本报syntax error主因是JSON字符串转义失败：未转义双引号、反斜杠或换行，而非PHP语法错；需用php -r json_decode定位，或粘贴到jsonlint.com验证，validate命令无法检测该类问题。
Composer 脚本（scripts）报 syntax error，基本不是 PHP 语法错，而是 JSON 层面的字符串转义、引号嵌套或换行处理失败——composer.json 里写脚本，本质是把命令塞进双引号字符串，而 JSON 不允许未转义的换行、反斜杠、双引号。
scripts 字段里写 PHP 命令为什么会报 syntax error
因为 scripts 的值是 JSON 字符串，不是 PHP 代码块。你写的 "php -r "echo 'hello';"" 必须满足两层规则：JSON 合法 + shell 可执行。常见翻车点：
- 没对内部双引号做转义：
"php -r "echo 'x'"❌ → 外层 JSON 字符串在第一个"就结束了 - 用了单引号包裹整个命令：
'php -r "echo 1;"'❌ → JSON 只认双引号，单引号直接解析失败 - 命令含换行或制表符：JSON 不允许裸换行，必须写成
+拼接（不推荐） - Windows 路径里的反斜杠没转义：
"php ./src\cli.php"❌ → 应写成"php ./src\\cli.php"或统一用正斜杠"php ./src/cli.php"
怎么快速定位 scripts 报错的具体位置
别靠 composer validate —— 它只校验字段结构，不验证字符串内容能否被 shell 解析。真正有效的是：
- 用
php -r "json_decode(file_get_contents('composer.json'));"看是否直接报syntax error, unexpected end of file或Invalid escape sequence，这说明 JSON 层就崩了 - 把出问题的 script 值单独提出来，粘贴到在线 JSON 验证器（如 jsonlint.com），它会高亮未转义字符和非法换行
- 临时删掉其他
scripts条目，只留一个最小命令（如"php -v"），确认能过，再逐步加参数还原
scripts 中带参数的命令怎么安全写
核心原则：外层 JSON 双引号包住整个命令，内部所有双引号、反斜杠、$ 符号必须转义。实际建议分三类处理：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 纯 CLI 命令（无双引号/变量）：
"php artisan migrate"✅ 直接写，不用转义 - 含单引号的 PHP -r 命令：
"php -r "echo 'done';"✅ 用"替代内部双引号，最省事 - 含变量或复杂 shell 逻辑：
"sh -c "php -r \"echo getenv('APP_ENV');\""✅ 外层"，内层\"，逐层加反斜杠
更稳妥的做法是把逻辑抽到独立 PHP 文件里，scripts 只调用它，避免在 JSON 里硬拼长命令。
为什么 validate 通过了，运行时还报 syntax error
composer validate 只检查 scripts 是个字符串数组，不验证字符串内容是否可被 shell 执行。所以：
-
"scripts": {"test": "php -r "echo 1;""}会过validate，但运行composer test时 shell 解析失败，报syntax error near unexpected token `echo' -
composer run-script是直接交给系统 shell 执行，等价于你在终端敲那条命令——所以终端能跑通，scripts才大概率没问题 - 如果脚本含环境变量、管道、重定向（
|、>、&&），务必用sh -c包一层，否则 Windows 和 Linux 行为不一致
真正要命的不是 JSON 错误，而是 shell 解析时的上下文丢失——比如当前工作目录、PATH、.env 加载状态，这些 scripts 都不自动继承，得手动处理。
