答案是用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 环境常在这里翻车
composer.json 主体，而是它 include 的外部配置、或通过环境变量注入的 JSON 片段。先关掉所有动态注入，用纯静态文件测试。
