vendor/composer/installed.json 编码不一致导致 json_decode 返回 null，主因是旧版 Composer 生成时未统一 UTF-8 无 BOM；应升级至 2.5.0+ 并统一源文件编码，运行时用 mb_convert_encoding 容错。
vendor/composer/installed.json 编码不一致导致解析失败
直接 json_decode(file_get_contents('vendor/composer/installed.json')) 返回 null，大概率不是 JSON 格式错误，而是文件编码混杂。旧版 Composer（2.2.x 之前）在生成该文件时，若原始 composer.json 是 GBK 或含 UTF-8-BOM，会把中文字段写成乱码或截断，后续 json_decode() 就失效。
实操建议：
围绕关键发现、作用机制、临床相关性及研究局限性展开讨论。适用于撰写或优化任何生物医学论文的“讨论（Discussion）”部分——包括结果解读、与既往文献关联、阐释意外发现、界定研究局限性，以及撰写结论。当用户输入以下任一指令时也会自动触发该功能： - “write my discussion” - “help me discuss my findings” - “how do I compare to prior studies” - “write the limitations par
- 统一所有
composer.json保存为 UTF-8 无 BOM（VS Code / PHPStorm 右下角可切换） - 升级 Composer 至 2.5.0+，该版本强制对
installed.json做 UTF-8 校验与转义 - 运行时加容错：用
mb_convert_encoding($data, 'UTF-8', 'UTF-8,GBK,GB2312')再 decode
autoload_classmap.php 比静态扫描更可靠
想建立「类名 → 物理路径」精确映射，别逐个 file_get_contents() 扫描 vendor 下数万文件。Composer 已在 vendor/composer/autoload_classmap.php 中预编译好 $classMap 数组，内容完整、格式稳定、无需解析。
实操建议：
- 优先读取
autoload_classmap.php，直接include获取数组 - 对
"files"类型加载项（如["src/functions.php"]），需额外用token_get_all()提取function和const声明，补入索引 - PSR-0 映射不能套用 PSR-4 规则：下划线要转斜杠，且必须按 namespace 前缀做前缀匹配，否则路径错位
大 JSON 文件（如 packages.json）不靠解析优化，而靠规避
Composer 不替换 json_decode()，也不流式解析。所谓“同步卡住”，99% 是镜像未同步完 provider-*.json，而非解析慢。当全量 packages.json 达到 20+ MB，真正瓶颈是整块字符串常驻内存，极易 OOM。
实操建议：
- Composer 2.2+ 默认跳过全量
packages.json，改用分片provider-*.json；不要指望换版本自动优化大 JSON - CI 中检测
provider-laravel~10.0.json返回 404 后，sleep 10再试，而非立刻 fallback 到更慢的全量源 - 临时切国内镜像源：
composer config -g repo.packagist composer https://mirrors.ustc.edu.cn
类映射权威模式（classmap-authoritative）影响查询路径精度
启用 --classmap-authoritative 后，Composer 自动加载器只查 classmap，完全忽略 PSR-4/PSR-0 的目录扫描逻辑。这对性能是利好，但对元数据索引系统是陷阱——你从 autoload_psr4.php 读到的命名空间映射，在运行时根本不会被加载器使用。
实操建议：
- 构建索引时，必须区分环境：生产环境启用了权威模式，就只能依赖
autoload_classmap.php；开发环境未启用，才需同时处理 PSR-4 映射 - 不要假设
composer dump-autoload --optimize输出的映射表覆盖全部类——它只包含实际存在的类文件，而 autoload 配置里声明的路径可能含未提交的 stub 或占位文件 - 检查项目是否设了
"optimize-autoloader": true，该配置会隐式启用权威模式
