文件右下角显示read-only是文件系统权限/属主错位所致，需用sudo chown -R $USER:staff（macOS）或$USER:$USER（Linux）修复所有权，再Reload project from Disk生效。
文件右下角显示 read-only 是权限问题，不是 IDE 设置错
PhpStorm 里文件标签或状态栏出现锁图标、提示 read-only，第一反应不该是翻 Settings 或关插件——90% 情况下是文件系统权限/属主错位。IDE 只是“如实反映”你没写权限，它本身不主动加锁。
验证方式很简单：终端执行 ls -l path/to/file.php，重点看两处：
- 第三列（如显示
root或别人用户名）：如果不是whoami输出的当前用户名，就是根源 - 第一列权限位（如
-r--r--r--）：即使有w，但属主不对，照样写不了
别急着 chmod 777 ——这等于给所有用户开后门，Web 服务器若以同一用户运行，极易被恶意覆盖。
用 chown 修复属主才是治本操作
属主错了，chmod 就是无效动作。必须把所有权还给当前用户，才能让 PhpStorm 以正确身份写入。
立即学习“PHP免费学习笔记（深入）”；
macOS 下执行：
sudo chown -R $USER:staff /path/to/project
Linux 下执行：
sudo chown -R $USER:$USER /path/to/project
单个文件可简化为：
sudo chown $USER:staff file.php
注意：$USER 是 shell 变量，会自动展开成当前用户名；不要手敲 yourname 然后拼错。
修复后不用重启 PhpStorm，点菜单 File → Reload project from Disk 或重新打开文件即可刷新状态。
idea.max.intellisense.filesize 要改，但得配套调 JVM 内存
如果文件本身大于 2.56MB（比如生成的 JSON、日志片段、大 SQL 导出），PhpStorm 会主动截断并设为只读——这不是权限问题，而是内存保护策略。
必须同步做三件事：
- 在
Help → Edit Custom Properties…中添加：idea.max.intellisense.filesize=999999（单位 KB，≈1GB） - 修改
phpstorm.vmoptions，把-Xmx至少提到-Xmx2048m；-Xmx不要超 4G，否则 JetBrains 官方明确警告会启动失败或 GC 失控 - 进
Settings → Editor → Inspections，关掉 PHP/JS/HTML 所有实时检查项——对几十 MB 的源码做语法分析只会卡死 UI
只改 idea.max.intellisense.filesize 不调内存，加载大文件时大概率触发 java.lang.OutOfMemoryError: Java heap space 直接冻结。
状态栏点锁图标能临时解锁，但下次 Git 操作就失效
点击状态栏右下角的锁图标，或执行 File → Make File Writable，确实能让当前会话可编辑——但这只是 IDE 层面的覆盖开关，不改变底层权限。
以下场景会让锁立刻回来：
-
git stash pop恢复了 root 写入的文件 - PhpStorm 重载项目（比如
Reload project from Disk） - 系统重启后重新挂载 NFS/Docker volume，UID 映射错乱
多人协作或 CI 环境中依赖这种手动切换，等于埋定时炸弹。真正稳定的做法，是从第一次 git clone 或 composer install 开始，就确保所有者和权限属于当前用户。
