PhpStorm不会上传只读文件且不报错，仅在Deployment Log中记录Permission denied；需检查文件权限、属主匹配性及时间戳偏差，排除NFS/Docker只读限制或IDE文件大小保护机制。
PhpStorm 不会跳过只读文件——它根本不会上传，且不报错，这是默认行为。所谓“跳过”，其实是上传动作被静默拦截：只要文件系统标记为只读（chmod -w 或属主不匹配），SFTP 上传就会失败，但 PhpStorm 默认不提示，只在 Deployment Log 里记一条无上下文的 Permission denied。
怎么确认是只读导致上传失败
上传后远程文件没变，但 PhpStorm 状态栏仍显示 Uploaded 1 file，这是典型假成功。真正线索在日志里：
- 打开
View → Tool Windows → Deployment → Log - 找包含
Permission denied、Read-only file system或Operation not permitted的条目 - 终端验证：
ls -l /path/to/file.php，看权限位是否含-w，第三列用户是否与 SFTP 登录用户一致
只读文件上传失败的三种真实原因和对应解法
不是所有“只读”都一样，得先分清来源：
-
文件系统级只读：比如 NFS 挂载盘、Docker volume 设置了
ro，或chattr +i锁死。解法：改挂载参数或chattr -i，PhpStorm 无法绕过 -
Linux 权限缺失：文件属主是
root，但你用deploy用户连 SFTP。解法：远程执行sudo chown deploy:deploy /path/to/file.php，或让运维加 sudo 权限 -
PhpStorm 自身截断式只读：文件 >2.56MB 触发
idea.max.intellisense.filesize保护，显示小锁图标。这不是系统只读，而是 IDE 主动禁写。解法：改配置并重启，见「PhpStorm提示文件过大被设为只读」指南
别试图用 Excluded paths 绕过只读问题
Excluded paths 只控制“哪些文件不参与上传”，不解决“上传时权限失败”。把只读文件加进排除列表，结果是：它既不传，也不报错，更难定位问题。真要临时跳过某类文件（比如日志），应明确用路径排除，例如：
立即学习“PHP免费学习笔记（深入）”；
logs/** *.log cache/**
但注意：这跟“只读”无关，只是提前过滤掉不该上传的文件类型。
上传前自动检测只读状态的实操建议
PhpStorm 没有内置检查，但你可以用最小成本防踩坑：
- 在
Settings → Tools → Terminal里把 Shell path 改成zsh或bash，然后每次上传前在 Terminal 执行：find . -type f ! -writable -name "*.php" | head -5 - 把常用部署目录加进
Deployment → Options → When files are changed outside PhpStorm设为Compare and ask，这样本地改完保存时，如果远程文件不可写，至少会弹窗提醒 - 如果项目跑在 Docker 容器里，确保 SFTP 用户对容器内挂载路径有写权限，别只改宿主机权限
最常被忽略的一点：时间戳偏差超 60 秒时，PhpStorm 会误判文件“未改动”而跳过上传，看起来像只读，实际是同步逻辑失效。遇到上传静默失败，先关掉 Compare files by time stamp 再试。
