磁盘空间满直接导致sublime text无法保存文件、崩溃或报error: disk full，需先释放空间，再彻底退出后同步清理cache、local/index、local三类缓存，并禁用index_files防止复发。
磁盘空间满直接导致 Sublime Text 无法保存文件、崩溃或报 Error: disk full，这不是编辑器 bug，而是系统级写入失败。必须先释放空间，再清理 Sublime 自身缓存，否则重启也无效。
确认磁盘已满并快速释放空间
Sublime 报 Error: disk full 时，它只是被动暴露了底层问题。Windows/macOS/Linux 都会返回类似 Disk full (Error 61)，说明 Write # 或 Close 操作被内核拒绝。
- 先用系统命令确认：macOS/Linux 执行
df -h，Windows 运行df（PowerShell）或看资源管理器中 C:/ 或主分区剩余空间 - 重点清临时目录：
/tmp（macOS/Linux）、%TEMP%（Windows）、~/Library/Caches（macOS）——这些常被 Sublime 插件或构建脚本写爆 - 别只删大文件：
node_modules、.git、dist目录在项目根下占空间最多，但它们不直接导致 Sublime 写失败；真正压垮磁盘的是日志、缓存、编译产物（如~/.cache/sublime-text/Cache下的 gigabytes 级数据） - 云同步服务（OneDrive、iCloud）卡在上传队列时也会持续占用磁盘空间，暂停同步再清理更稳妥
彻底退出 Sublime 后清理三类关键缓存路径
磁盘刚腾出空间，Sublime 若仍卡住或保存失败，大概率是旧缓存损坏后反复尝试写入失败。只删 Cache 不够，Index 才是罪魁祸首——它存全文搜索和跳转数据库，损坏后会持续触发写操作直至磁盘再次写满。
- 必须先杀干净进程：Windows 查任务管理器中
sublime_text.exe和subl.exe；macOS 在活动监视器里强制退出所有com.sublimetext.4；Linux 执行pkill -f "sublime_text" - 同步删除以下三类路径（缺一不可）：
-
Cache：临时编译结果，删完重启自建，安全 -
Local/Index：核心索引库，体积大、易损坏，删它才能修复Ctrl+R失效、CPU 100% 等症状 -
Local：存 UI 状态和崩溃快照，长期不清理会导致启动卡顿、菜单错位
-
- 路径示例（按系统）：
- Windows：
%APPDATA%Sublime TextCache、%LOCALAPPDATA%Sublime TextLocalIndex、%APPDATA%Sublime TextLocal - macOS：
~/Library/Application Support/Sublime Text/Local/Index、~/Library/Caches/Sublime Text、~/Library/Application Support/Sublime Text/Local - Linux：
~/.config/sublime-text/Local/Index、~/.cache/sublime-text、~/.config/sublime-text/Local
- Windows：
禁用 index_files 防止复发
即使清完缓存，只要打开含 node_modules 的项目，index_files 默认开启就会立刻重新扫描上万文件，再次吃光磁盘空间并拉满 CPU。这不是可选优化，是必须关的开关。
- 打开
Preferences → Settings，在右侧用户设置中添加："index_files": false - 改完必须彻底退出再重启——仅重载设置无效，后台索引线程仍在运行
- 副作用明确：
Ctrl+R（跳转符号）、Find All References会失效；但Ctrl+P（按文件名）、Ctrl+Shift+F（全局文本搜索）完全不受影响 - 别信“我只开了一个 JS 文件”——只要项目目录下存在未排除的
node_modules，Sublime 就会递归扫描，不管当前打开哪些标签页
检查插件残留和构建系统路径空格
磁盘空间恢复后仍报写失败，常见于两类隐藏问题：LSP 插件后台进程持续写日志，或构建系统调用含空格路径的解释器失败。
- LSP 类插件（如
pyright、texlab）卸载后，其语言服务器可能仍在后台运行。检查Packages/User/下是否残留LSP-pyright.sublime-settings，并在Cache/路径中搜索并删除对应文件夹 - 构建系统若调用
C:Program FilesPythonpython.exe，必须确保cmd数组第一项是完整双引号包裹的字符串："C:\Program Files\Python\python.exe"。单引号、反斜杠转义空格均无效，cmd.exe只认外层双引号 - 注册表右键菜单异常（如点击 .py 文件闪退），检查
HKEY_CLASSES_ROOT*shellSublimeTextcommand的默认值是否为"C:Program FilesSublime Textsublime_text.exe" "%1"——前后双引号缺一不可
真正麻烦的不是磁盘满本身，而是 Sublime 在满盘状态下持续尝试重建索引、写缓存、拉起 LSP 进程，形成恶性循环。清空间、杀进程、删 Index、关 index_files 这四步必须闭环执行，漏掉任何一环都可能第二天又弹出 Error: disk full。
