windows路径超260字符时sublime保存静默失败，因系统api拦截createfilew调用；验证用test-path，绕过法包括映射网络驱动器、启用注册表longpathsenabled或禁用atomic_save。
Windows 路径长度超过 260 字符时保存失败
Windows 默认启用 MAX_PATH 限制（260 字符），当 Sublime 打开的文件路径（含盘符、目录、文件名、扩展名）总长超此值，Save 操作会静默失败——不报错、不弹窗、状态栏仍显示 modified，但磁盘文件时间戳不变。这不是 Sublime 的 bug，而是 Windows API 层面拦截了 CreateFileW 调用。
验证方式：在 Sublime 控制台（Ctrl+`）中执行：view.file_name()，复制输出路径，粘贴到 PowerShell 中运行：Test-Path "你的完整路径" —— 若返回 False，基本确认是路径过长导致系统级拒绝访问。
- 临时绕过：在文件资源管理器中，将项目根目录映射为网络驱动器（如
net use X: "\?C: erylongpath oproject"），再用 Sublime 打开X: ile.txt；注意\?前缀必须由系统解析，不能手动加进 Sublime 路径框 - 永久修复（需管理员权限）：修改注册表
HKEY_LOCAL_MACHINESYSTEMCurrentControlSetControlFileSystemLongPathsEnabled，设为DWORD = 1；随后重启 Explorer 或整个系统（仅 Win10 1607+ / Win11 生效） - 更稳妥的做法：把项目移到更短路径，例如
C:proj或\wsl$Ubuntuhomeusercode（WSL2 内部路径不受此限）
Sublime 的 atomic_save 在长路径下触发 rename 失败
默认开启的 atomic_save 会让 Sublime 先写入临时文件（如 C: erylongpath o ile.txt.tmp），再重命名为原文件。但 Windows 对 MoveFileEx 的路径长度限制比 CreateFile 更严，尤其当临时路径拼接后突破 240 字符时，rename 直接失败，且 Sublime 不记录任何错误日志。
临时禁用可快速验证是否为此问题：
打开 Preferences → Settings，在用户设置中添加："atomic_save": false
- 禁用后 Sublime 改为直接覆盖原文件，规避 rename 环节，但失去原子性保障（断电/崩溃可能导致文件损坏）
- 若禁用后保存成功，说明问题出在 atomic_save + 长路径组合；长期使用建议配合短路径或注册表修复
- 不要全局关闭 —— 只在确认受影响的项目中局部设置，例如通过
Project → Edit Project添加"settings": {"atomic_save": false}
WSL2 / Linux 子系统挂载路径下的路径长度陷阱
当 Sublime 运行在 Windows 上，却打开 /mnt/c/Users/name/project/... 下的文件时，路径经 WSL2 转义后实际长度翻倍（如 /mnt/c → \wsl$Ubuntuhomeuser...），且 Windows 层面对 /mnt/ 路径的符号链接处理不稳定，容易在保存时卡在 rename 或权限检查阶段。
- 避免直接编辑
/mnt/下的文件：改用 WSL2 内置编辑器（如code-insiders --remote wsl+）或 VS Code Remote - 若必须用 Sublime，先将文件
cp到 Windows 本地路径（如C: mp），编辑完再cp回去；不要用剪切粘贴，避免跨文件系统元数据丢失 - 检查 WSL2 是否启用
metadata：在/etc/wsl.conf中确认有[automount] enabled = true options = "metadata"，否则 NTFS 权限无法正确映射，加剧保存失败
OneDrive / Dropbox 同步中文件的“伪长路径”问题
云同步工具常在文件路径末尾插入隐藏标识（如 .onedrive 后缀、~$ 锁定文件），或启用“按需文件”模式后，文件实际未下载到本地磁盘。此时 Sublime 认为路径合法，但系统调用 WriteFile 时被同步客户端拦截，表现与长路径一致：无声失败。
- 右键文件 → “属性” → 查看“常规”页签底部是否有“OneDrive 已同步”或“可用脱机”字样；若有，右键 → “始终在此设备上保留”
- 临时退出 OneDrive 客户端（任务栏图标右键 → “关闭 OneDrive”），再试保存；若成功，说明是同步服务干扰
- 避免将项目放在
OneDriveDocuments或DropboxProjects下——这些路径本身不长，但同步元数据叠加后易触发边界条件
atomic_save、云同步、WSL2 挂载三者任意两者的组合；单独一项通常有解，叠加之后错误现象会消失在控制台日志之外，只能靠路径长度测量 + 设置开关 + 同步状态交叉验证。
