应使用php -r命令或jsonlint.com定位：执行php -r "json_decode(file_get_contents('composer.json')) || die('JSON error: '.json_last_error_msg());"可获错误提示，PHP 8.0+附带偏移量；粘贴内容至jsonlint.com则精确标出违规行与字符，如末尾逗号、BOM头或中文标点。
composer install 报 JSON decode error 怎么快速定位到具体字符
错误本质是 composer.json 文件被 PHP 的 json_decode() 拒绝解析，不是镜像或网络问题。Composer 自带的报错（如 Parse error on line 12 at column 5）已经给出坐标，别从头扫文件——问题就在第 12 行第 5 列附近。
实操建议：
- 直接运行：
php -r "json_decode(file_get_contents('composer.json')) or die('JSON error: '.json_last_error_msg());"，PHP 8.0+ 会附带偏移量（如offset 123），配合编辑器「显示不可见字符」功能可秒定位 - 粘贴内容到 jsonlint.com（关掉“允许注释”），它会高亮非法字符：末尾逗号、中文引号、全角冒号、零宽空格（U+200B）、UTF-8 BOM 头（
ef bb bf） - 用
jq '.' composer.json（需先brew install jq或apt install jq）：失败时直接输出行列号，比composer validate更底层、更敏感
哪些“看起来正常”的写法实际触发 JSON decode error
JSON 是严格子集，很多 PHP 数组或手写习惯在这里是非法的，改错一个就全挂：
- 对象或数组末尾多逗号：
"require": { "monolog/monolog": "^2.0", }→ 删掉最后那个, - 用了单引号或中文引号：
'name': 'my/app'或“name”: “my/app”→ 必须全用英文双引号："name": "my/app" - 写了注释：
// dev-only或/* required */→ JSON 不允许任何注释，一律删掉 - 路径含 Windows 反斜杠：
"psr-4": { "App": "src\" }→ 改成正斜杠："App": "src/"（注意 namespace 里的是合法的，目录路径必须用/） - 文件开头有 BOM：
file -i composer.json输出含charset=utf-8-with-bom→ 用 VS Code 右下角点击编码名 → 「Save with Encoding」→ 选UTF-8（不是UTF-8 with BOM）
为什么 composer validate 不报错但 install 还失败
composer validate 只校验 JSON 结构 + 官方 schema 字段存在性，不触发真实 json_decode()；而 install 会读取并解析内容，所以：
dmap-jsapi-skill
下载
DMap GL地图JSAPI（dmapgl）开发指南。用于编写、审查、调试 DMap 地图 API 代码，涵盖地图初始化、覆盖物渲染、图层管理、事件处理、控件交互等任务。当用户提及 dmap、dmapgl、jsapi‑gl 或相关地图开发需求时自动触发。
-
"version": "dev-main"：validate通过，但若 Packagist 上不存在该分支，install报找不到包 -
"autoload": { "psr-4": { "App": "src//" } }：validate不管路径末尾多斜杠，dump-autoload却会警告路径不存在 -
"config": { "allow-plugins": {} }：Composer 2.2+ 才支持，老版本validate不识别也不报错，但执行时报未定义
换中文镜像后报 Could not parse version constraint 怎么办
这不是 composer.json 格式问题，而是旧版 Composer（尤其是 1.x）无法解析国内镜像精简后的 packages.json 结构。阿里云、腾讯云等镜像为加速长期缓存并裁剪元数据，但 Composer 1.10.22 等版本只认原始格式——比如把 providers 数组改成单个 provider 字段，就会触发 UnexpectedValueException。
必须强制切回官方源 + 清缓存，绕过所有 fallback：
- 全局覆盖源地址：
php composer.phar config -g repo.packagist composer https://packagist.org - 清空全部缓存：
php composer.phar clear-cache（不清缓存 = 白配） - 验证是否生效：
php composer.phar config -g repo.packagist必须输出{"type":"composer","url":"https://packagist.org"}，且字段名为单数repo.packagist，末尾带/ - 项目级配置更稳：
"packagist.org": false必须加在repositories后，否则仍会 fallback 到官方源
真正容易被忽略的是：BOM 和末尾逗号这类字符在编辑器里完全不可见，靠肉眼几乎无法发现；而 composer validate 的“通过”极具欺骗性——它不等于文件能被成功加载。
