答案是用jsonlint.com高亮非法字符或执行php -r命令定位：JSON解析错误90%源于末尾逗号、中文引号、BOM头、全角符号或require中非法版本约束（如末尾空格、beta写法错误），须用UTF-8无BOM重存并校验双引号与版本语法。

composer.json 里有非法字符或缩进错误

Composer 解析 composer.json 是严格按 JSON 格式来的，哪怕多一个逗号、少一个引号、用 tab 缩进（某些编辑器会混入不可见字符）、末尾多空格，都会直接报 Syntax error 或 JSON decode error。

• 用 jsonlint 或在线工具（如 jsonlint.com）粘贴内容验证，别信 IDE 的“看起来没问题”
• 特别注意 Windows 记事本保存的 UTF-8 BOM 头：它会让 composer install 读到开头的 \ufeff，报错却不说哪行——用 VS Code 或 Notepad++ 选 “UTF-8 无 BOM” 重存
• 检查所有双引号是否为英文直角引号，中文输入法下容易打成全角 “”

require 字段里写了非法版本约束

常见错误不是版本号写错，而是用了 Composer 不认的语法，比如：

Discussion Composer

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

下载

• "laravel/framework": "10.x-dev " —— 末尾空格导致解析失败，报错指向 require 行但不提示空格问题
• "monolog/monolog": "^2.0.0-beta" —— beta 不是合法稳定性标识，得写成 2.0.0-beta1 或加 --stability=beta
• "php": ">=8.1 写成 <code>"php": ">=8.1 && —— <code>&& 是无效操作符，Composer 只认空格分隔的约束链

platform 配置写错格式或值非法

"config": {"platform": {...}} 里写的 PHP 或扩展版本，必须是 Composer 能校验的合法字符串，否则 composer install 会卡在解析阶段，报错信息模糊。

• "php": "8.2.10" 看起来对，但实际要求是语义版本格式："8.2.10 是合法的；"8.2" 也合法；但 "8" 或 "8.2.10.1" 就不行
• "ext-mbstring": "true" 错了 —— platform 不接受布尔值，应写 "ext-mbstring": "*" 或留空（表示“必须存在”，不校验版本）
• 如果写了 "ext-imagick": "3.7.0"，而系统里 imagick 是 3.7.1，也会失败 —— platform 是精确匹配，不是范围匹配

vendor 目录残留损坏导致 autoload 解析失败

有时 composer install 显示成功，但后续运行脚本时报 Class not found 或 require(): Failed opening required 'vendor/autoload.php'，其实是 vendor/ 里文件不完整或权限错乱，让 Composer 在生成 autoload 时静默出错。

• 删掉整个 vendor/ 和 composer.lock，再跑 composer install —— 别只删 vendor/，composer.lock 里可能还记着旧路径
• 确认 vendor/autoload.php 文件存在且可读：ls -l vendor/autoload.php，若属主是 root 而你用普通用户运行，就会权限拒绝
• 如果项目用了自定义 autoloader（比如 "autoload": {"psr-4": {...}}），检查路径是否拼错，尤其是大小写 —— macOS 不敏感，Linux 敏感，CI 环境常在这里翻车

最常被忽略的是：报错说“syntax error”，但真正出问题的往往不是 composer.json 主体，而是它 include 的外部配置、或通过环境变量注入的 JSON 片段。先关掉所有动态注入，用纯静态文件测试。