<p>Composer不支持中文注释，因JSON规范禁止注释，php json_decode()遇//或/ /直接报Syntax error；中文字段合法但须UTF-8无BOM编码。</p>
Composer 本身不支持中文注释，任何在 composer.json 里写的中文注释都会导致解析失败或乱码——这不是编码设置能绕开的问题，而是 JSON 规范和 Composer 实现共同决定的硬限制。
为什么 composer.json 不能写中文注释
JSON 标准（RFC 7159）允许字符串中出现 UTF-8 编码的中文，但明确禁止注释。PHP 的 json_decode() 函数在解析时遇到 // 或 /* */ 会直接报错：JSON decode error: Syntax error。即使你用编辑器强行保存带注释的文件，Composer 读取时也根本不会走到“解码中文”那步，而是卡在语法校验阶段。
常见误操作包括：
- 用 VS Code 在
composer.json里写// 依赖说明，保存后看似正常，但composer install直接失败 - 从网页复制带中文注释的配置片段，粘贴进文件后没删注释就执行命令
- 以为改成 UTF-8 编码就能“兼容注释”，结果错误信息里连具体行号都不显示
composer.json 中文字段必须是 UTF-8 无 BOM
只要不含注释，中文键名或值（如 "name": "我的项目"）是合法的，但必须满足两个条件：
- 文件编码必须是
UTF-8，且不能带 BOM——Windows 记事本默认保存的“UTF-8”几乎总是带 BOM - 验证方式：Linux/macOS 下运行
xxd composer.json | head -n1，开头不应出现ef bb bf；Windows 下可用 PowerShell 执行(Get-Content composer.json -Raw)[0] -eq [char]0xfeff，返回True就说明有 BOM - 安全保存方式：VS Code 右下角点击编码 →
Save with Encoding→ 选UTF-8（注意不是UTF-8 with BOM）
IDE 编码设置对 composer.json 没用？不，它影响的是你“怎么改”
IDE 的文件编码设置本身不改变 Composer 行为，但它决定了你编辑时看到的字节流是否准确：
- 如果 IDE 把
composer.json当作GBK打开，你输入的中文会被按 GBK 编码存入文件，后续 Composer 用 UTF-8 解析就会变成\uXXXX或直接报错 - 正确做法：在 IDEA 或 VS Code 中，右下角确认当前文件编码显示为
UTF-8，若显示GBK，先点它 →Reload（仅重解释，不改内容），再点 →Convert to UTF-8（真正转码并保存） - 别跳过
Reload步骤：直接Convert会导致原 GBK 字节被错误地当 UTF-8 转换，中文彻底变乱码
终端输出中文乱码？那是另一层问题
即使 composer.json 完全合规，composer install 输出的中文（如包名、提示语）仍可能乱码，这和文件编码无关，而是终端环境问题：
- Windows CMD 默认代码页是
chcp 936（GBK），而 Composer 输出的是 UTF-8 字节流 → 运行chcp 65001临时切到 UTF-8 - PowerShell 需确认：
[console]::OutputEncoding返回System.Text.UTF8Encoding，否则加启动参数或改系统设置 - Git Bash 和 Windows Terminal 天然支持 UTF-8，优先用它们跑 Composer 命令
最麻烦的情况是：你改对了 composer.json 编码，终端也设对了，但 PHP 自身的 default_charset 或 mbstring.internal_encoding 是 GBK ——这时 Composer 的 PHP 运行时会把 UTF-8 字符串错误地当 GBK 处理，输出必然乱。这种情况得查 php.ini，不是 IDE 能解决的。
