VSCode无全局禁用缓存开关,只能通过--cache-dir重定向缓存位置、手动清理多处分散缓存(如WorkspacesStorage、extensions等)或配置项弱化依赖;必须彻底退出进程后操作,且--cache-dir仅对指定启动方式生效。

VSCode 没有“禁用本地缓存”的全局开关,所谓“禁用”实际是控制缓存写入位置、清除已有缓存、或绕过特定缓存机制。盲目删缓存目录或关掉所有缓存功能会导致搜索变慢、启动延迟、甚至插件异常。
怎么改 --cache-dir 启动参数迁移缓存位置
VSCode 的缓存(日志、工作区索引、临时文件)默认全塞在 C 盘用户目录下,--cache-dir 是唯一能从源头重定向它的方法,且优先级高于环境变量和符号链接。
- 必须彻底关闭 VS Code:任务管理器里杀掉所有
Code.exe和Code Helper.exe进程 - 右键桌面/开始菜单的快捷方式 →「属性」→「快捷方式」选项卡
- 在「目标」末尾加空格后追加:
--cache-dir "D:\VSCode\Cache"(路径必须英文双引号包裹) - 保存后双击该快捷方式启动,新缓存只写入 D 盘,旧缓存不会自动迁移,需手动清理
为什么直接删 %APPDATA%\Code\Cache 不够用
删 Cache 目录只能清掉部分临时文件,但 VSCode 的搜索索引、语言服务器快照、终端渲染缓存等,分散在多个位置:
-
%APPDATA%\Code\WorkspacesStorage\:每个工作区的搜索索引都藏在这里,删它才能让 Ctrl+Shift+F 不再扫出已删文件 -
%APPDATA%\Code\User\sessions\:同步会话缓存,影响插件状态恢复,同步出问题时必清 -
%USERPROFILE%\.vscode\extensions\:插件自身缓存(如 TypeScript 语言服务的语义索引),删它会触发重分析,但可能卡住几秒
只删 Cache 目录,等于只擦了黑板,没动讲义和教案。
哪些缓存能“逻辑禁用”,哪些根本绕不开
有些缓存 VSCode 强制启用,无法关闭;另一些则可通过设置弱化依赖:
-
search.usePCRE2设为false:禁用 PCRE2 正则引擎后,VSCode 放弃复用旧索引快照,每次搜索都重新扫描(不是真禁缓存,但效果接近“不信任缓存”) -
files.watcherExclude配在项目.vscode/settings.json中:阻止监听 node_modules 等目录,相当于砍掉缓存的数据源头,比事后清缓存更治本 -
terminal.integrated.enablePersistentSessions设为false:禁用终端会话持久化,每次关终端就丢历史,不写磁盘缓存 - 但
storage.local(UI 状态、面板折叠、编辑器布局)和workbench.state(窗口位置、上次打开文件)这两类缓存无开关,删了重启就重建
容易被忽略的关键点
所有缓存操作都依赖进程干净退出——哪怕只剩一个隐藏的 Code Helper (Renderer) 进程,你删掉的目录可能被锁住,重启后又原样恢复;--cache-dir 只对通过该快捷方式启动的实例生效,命令行敲 code . 或右键“用 VS Code 打开”仍走默认路径;search.history 是 settings.json 里的字符串数组,不是缓存文件,但它会让搜索框不断推荐已删文件的关键词,看着像缓存残留,实则是配置项在作祟。


















