composer.json被标记为只读时，运行require/update等命令会报“could not write to composer.json”或“permission denied”；需检查windows文件属性、linux/macos权限与归属、git锁定状态及ide文件占用，并确保操作路径正确。
composer.json 文件被标记为只读时的典型表现
运行 composer require、composer update 或任何会修改 composer.json 的命令时，报错类似：Could not write to composer.json 或 file_put_contents(composer.json): failed to open stream: Permission denied。
这不是 Composer 本身的问题，而是操作系统层面拒绝写入。Windows 下常见于文件属性勾选了「只读」；Linux/macOS 下则是文件权限或父目录权限不足。
检查并清除 Windows 下的只读属性
右键 composer.json →「属性」→ 取消勾选「只读」→ 点击「应用」。
如果项目在 Git 仓库中，还要确认 Git 没有锁定该文件：
执行 git ls-files --eol composer.json 查看行尾符状态；若显示 locked，可尝试 git checkout -- composer.json（确保无未提交变更）。
更彻底的方式是用命令行批量清理：attrib -r composer.json（当前目录）或 attrib -r /s /d .\composer.json（递归子目录，慎用）。
Linux/macOS 下的权限与所有权问题
Composer 默认以当前用户身份运行，但若此前用 sudo composer 执行过命令，可能导致 composer.json 所属用户变为 root，普通用户就无法修改。
检查归属和权限：ls -l composer.json
若输出中 owner 不是你当前用户（如显示 root root），运行：sudo chown $USER:$USER composer.json
同时确保父目录可写：chmod u+w .（当前项目根目录）
注意：不要对整个 vendor 目录执行 chmod -R 777，这会破坏安全性且 Composer 后续可能拒绝工作。
IDE 或编辑器意外锁定文件
某些 IDE（如 PHPStorm、VS Code 的部分插件）会在编辑时对文件加锁，或启用「安全写入」机制（先写临时文件再替换原文件），导致 Composer 认为文件被占用。
临时解决方法：
– 关闭 IDE 中打开的 composer.json 标签页
– 检查是否有进程正在监听该文件：lsof composer.json（macOS/Linux）或 handle.exe composer.json（Windows Sysinternals 工具）
– 在终端中直接用 echo '{}' > composer.json 测试是否能写入——如果失败，说明不是 Composer 问题，而是环境级锁定
最常被忽略的是：错误发生在 vendor/ 目录下某个包的 composer.json（比如通过 composer install --no-scripts 后手动改过依赖），而你实际想改的是项目根目录的文件。务必确认操作路径和目标文件的绝对位置。
