composer.lock 报编码错误是因 UTF-8 BOM、非 UTF-8 locale 或中文路径导致 JSON 解析失败，需清除 BOM、统一 locale 并使用纯 ASCII 路径。
composer.lock 文件本身不运行，你遇到的其实是 Composer 命令执行时报编码错误——常见于 Windows 系统下终端或 Git Bash 中中文路径、UTF-8 BOM、或 locale 不匹配导致的解析失败。
为什么 composer install 会报 encoding 相关错误
Composer 在读取 composer.lock 时依赖 PHP 的 JSON 解析器（json_decode()），而该函数严格要求输入为 UTF-8 编码且**无 BOM**。一旦文件被编辑器（如记事本、某些 IDE）保存为带 BOM 的 UTF-8，或系统 locale 设为非 UTF-8（如 Windows 的 CP936），PHP 就会抛出类似 JSON decode error: Syntax error 或 Invalid UTF-8 sequence 的提示。
- 错误典型表现：
file_get_contents(): read of 8192 bytes failed with errno=22 Invalid argument（Windows + Git Bash） - 更隐蔽的情况：
composer install成功但依赖版本不一致，实则是composer.lock被部分跳过解析 - 不是文件内容“有中文”导致问题，而是编码元信息（BOM / locale / line endings）干扰了字节流解析
检查并清除 composer.lock 的 BOM 头
用二进制方式确认是否存在 BOM，再安全清除：
- Linux/macOS：运行
head -n1 composer.lock | hexdump -C | head -n1，若输出开头是ef bb bf，说明有 UTF-8 BOM - Windows PowerShell：运行
Get-Content composer.lock -Encoding Byte -TotalCount 3，结果为239 187 191即 BOM - 清除方法（推荐）：
sed -i '1s/^\xEF\xBB\xBF//' composer.lock（Linux/macOS）；Windows 可用 VS Code 打开 → 右下角点击编码（如 “UTF-8 with BOM”）→ 选择 “Save with Encoding” → 选 “UTF-8” - 切勿用记事本另存为 UTF-8 —— 它默认加 BOM；Notepad++ 保存时需手动选 “UTF-8 无 BOM”
统一终端和 PHP 的 locale 设置
尤其在 Windows + Git Bash / WSL 混合环境中，locale 不一致会导致 file_get_contents() 读取失败或乱码：
- Git Bash 中运行
locale，确保LANG和LC_ALL是 UTF-8 类型（如en_US.UTF-8或zh_CN.UTF-8） - 若显示
C或空值，在~/.bashrc加一行：export LANG=en_US.UTF-8，然后source ~/.bashrc - PHP 自身也受系统 locale 影响：在命令行运行
php -r "var_dump(setlocale(LC_ALL, 0));"，若返回false或空字符串，说明 PHP 未加载 locale 支持（Windows 下较常见，可忽略，但需确保文件编码干净） - 避免在含中文路径的目录中运行 Composer（如
C:\用户\xxx\project），改用纯 ASCII 路径（C:\work\project）
CI/CD 或部署时的隐性陷阱
GitHub Actions、GitLab CI 默认使用 UTF-8，但某些私有 Jenkins 或旧版 Docker 镜像可能用 POSIX locale，导致构建失败：
- Docker 中启动 PHP 容器前加：
ENV LANG=C.UTF-8 - GitHub Actions 示例片段：
env: LANG: C.UTF-8 LC_ALL: C.UTF-8
- Git 提交前强制标准化：
git config --global core.autocrlf input（Linux/macOS）或false（Windows），防止 CRLF 干扰 JSON 解析 - 最稳妥做法：把
composer.lock加入.gitattributes，声明为文本且禁用换行转换：composer.lock text eol=lf
真正卡住人的往往不是“怎么改”，而是没意识到 composer.lock 是一个被严格校验字节流的 JSON 文件——它对编码比 PHP 源码更敏感。BOM、混合换行符、非 UTF-8 locale 这三者任何一个存在，都可能让 Composer 在静默中跳过部分依赖或直接报错。动手前先用 hexdump 看一眼开头三个字节，比猜半天快得多。
