composer.lock json格式错误会导致composer install直接失败，应优先用jq或python3 -m json.tool验证合法性，报错时明确指出行列；若损坏则删除后重装，或执行composer update --lock重建。
composer.lock 文件一旦 JSON 格式出错，composer install 就会直接失败，且错误信息往往不指明具体哪一行——这不是环境问题，是文件本身已无法被 json_decode() 解析。
用 jq 或 python3 -m json.tool 快速验证 JSON 合法性
PHP 自带的 php -l 对 JSON 文件无效，别浪费时间。真正能定位语法错误的只有标准 JSON 解析器：
-
jq empty composer.lock：输出空行即合法；报错时会明确指出第几行第几列（如parse error: Invalid string: control characters from U+0000 through U+001F must be escaped at line 123, column 5） -
python3 -m json.tool composer.lock > /dev/null：报错时也会带行号，适合没装jq的环境 - 打开文件后开启编辑器「显示不可见字符」：重点查 BOM（
EF BB BF开头）、零宽空格、混用的\r\n和\n、中文引号、Unicode 转义不全（如张三没转成\u5f20\u4e09）
遇到 UnexpectedValueException 别猜，先盯 composer.lock 和 vendor/composer/installed.json
这个异常几乎总是由这两个文件之一损坏触发，composer install 在解析阶段就崩了，根本不会走到依赖安装逻辑：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 如果
jq报错指向composer.lock：直接删掉它，再跑composer install—— Composer 会按当前composer.json重生成一份干净的 lock - 如果报错指向
vendor/composer/installed.json：别修它，它是运行时自动生成的。删掉整个vendor/目录 +composer.lock，再执行composer install - Windows 或 WSL 下常见权限导致写入截断：
installed.json只有前半段 JSON，末尾缺失}。此时删vendor/是唯一可靠操作
Git 合并冲突后千万别手动删标记或调缩进
Git 冲突留下的 、<code>=======、>>>>>> origin/main 会让 JSON 直接非法；即使侥幸通过语法检查，字段顺序错乱、空行位置变动也会让 content-hash 校验失败：
-
composer install会报Invalid argument supplied for foreach()或静默装错包 -
composer update --lock是唯一安全重建方式：它完全忽略旧 lock，只读composer.json重新计算哈希和依赖快照 - 执行前确保
composer.json已无冲突（git checkout --theirs composer.json或手动整合完）
Composer 版本升级后 lock 文件不兼容怎么办
Composer 2.x 生成的 lock 文件含 plugin-api-version 和新哈希结构，1.x 无法识别；反过来，2.5+ 也会拒绝加载明显老旧的 lock 格式：
- 先备份原文件：
mv composer.lock composer.lock.bak - 运行
composer update --lock：重生成适配当前 Composer 版本的 lock，不改动composer.json中声明的版本 - 若提示平台不匹配（如 PHP 版本变更），加
--ignore-platform-reqs临时绕过，但上线前必须修正环境或composer.json中的platform配置 - 团队务必统一 Composer 版本，CI 脚本里应显式指定安装版本，避免混用 1.x 和 2.x
真正麻烦的不是报错本身，而是损坏可能藏得极深：比如 composer.lock 能通过 jq 验证，但某个包的 dist.sha256 字段为空或格式错乱，composer install 仍会在校验阶段失败——这种时候，composer update --lock 仍是比手修更稳的选择。
