Composer对JSON格式极其严格，末尾多逗号、引号错误等均报Syntax error；建议用VS Code实时校验、php -l检查基础语法、composer validate校验字段合法性，并注意路径须用正斜杠/、避免拼写错误。
composer.json 里多了一个逗号就报错
Composer 对 JSON 格式极其严格，哪怕 composer.json 末尾多一个逗号、少一个引号、用中文引号代替英文引号，都会直接报 JSON decode error: Syntax error。它不兼容 JavaScript 风格的宽松解析，也不提示具体哪一行出错——只告诉你“语法错误”，然后停住。
实操建议：
- 用 VS Code、PHPStorm 等现代编辑器打开
composer.json，它们会实时标红语法错误位置；别用记事本或 Sublime Text（没 JSON 插件时）硬改 - 终端执行
php -l composer.json快速检查是否是合法 JSON（注意：这只是基础语法校验，不验证 Composer 特定字段） - 如果改完后
composer install报错，先运行composer validate——它比单纯 JSON 解析更进一步，会检查字段名是否合法、require是否为空、版本约束格式是否正确等 - 复制内容到 jsonlint.com（确保关闭“允许注释”选项），它能准确定位行号和错误类型
composer validate 说 “The property xxx is not defined”
这不是 JSON 语法错，而是 Schema 校验失败。composer validate 默认启用严格模式，会比对官方 schema.json，拒绝任何未定义字段（比如手误写成 "requeire" 或加了自定义元数据但没声明 $schema）。
常见场景：
- 拼错字段名：
"requre"→ 应为"require"；"autoloa"→ 应为"autoload" - 在根级写了 Composer 不认识的键，例如
"notes"、"env"，又没加"$schema"声明（Composer 不支持用户自定义 schema 扩展） -
"autoload"下用了"psr-5"（不存在的标准）或路径值不是字符串数组（比如写成单个字符串而非["src/"]）
解决方法：对照 https://www.php.cn/link/5f783681c04fe0eca6ff5bb7838f1107 查字段定义；不确定时，删掉可疑字段，用 composer init 重生成最小可用配置再逐步加。
Windows 下路径反斜杠导致 autoload 失效
在 "autoload" 的 "psr-4" 或 "classmap" 中，如果手动写了 Windows 风格路径如 "src\Foo\"，Composer 会把它当字面量处理，最终生成的 autoloader 可能找不到类——因为 Composer 内部统一用正斜杠 / 分隔路径，且 PSR-4 映射要求 namespace 和目录结构严格对应。
关键点：
- 所有路径必须用正斜杠
/，无论什么系统；Composer 不做路径标准化转换 -
"classmap"数组里的路径是相对于composer.json所在目录的，别写绝对路径（如C:/project/src） - 如果用了
"files"加载全局函数，路径也要用/，且文件必须存在，否则composer dump-autoload会静默跳过（不报错但不生效）
示例错误写法："autoload": {"psr-4": {"App\": "src\App\"}} → 正确应为 {"App\": "src/App/"}
validate 通过但 install 仍失败：隐藏的版本约束冲突
composer validate 只管格式，不管逻辑。你可能看到绿色的 OK，但紧接着 composer install 卡在 Resolving dependencies 或报 Conclusion: don't install xxx ——这是依赖树无法满足，不是 JSON 错。
容易被忽略的地方：
-
"require"里写了"monolog/monolog": "^2.0 || ^3.0"这种 OR 表达式，Composer 支持，但某些旧版（ -
"minimum-stability"设为"dev"，但没配"prefer-stable": true，可能导致解析出大量 dev 分支版本，触发超时或内存溢出（尤其在 CI 环境） - 私有包仓库（
repositories）配置了但 URL 不可达，validate不检查网络连通性，install才暴露
这时候别只盯着 JSON，先跑 composer why-not vendor/package:version 定位冲突源头；或者临时加 -v 参数看详细依赖解析过程。
JSON 格式只是门槛，真正的坑藏在字段语义和依赖逻辑里。改完记得清缓存：composer clear-cache，不然旧错误可能反复出现。
