VSCode本地缓存需分别处理三类路径:vscode-cpptools(用VSCODE_CPP_TOOLS_CACHE_PATH环境变量)、Cache与Code Cache(用--cache-dir启动参数)、符号链接为兜底方案;仅改settings.json无效。

VSCode 的默认本地缓存目录不能通过设置界面直接修改,必须用启动参数或符号链接干预;否则 C 盘会持续被 vscode-cpptools、Cache、Code Cache 等目录吃掉空间。
哪些路径属于“本地缓存”且必须处理
别只盯着 .vscode/extensions —— 那只是扩展安装目录。真正占空间的本地缓存有三类,行为和修改方式完全不同:
-
%LocalAppData%\Microsoft\vscode-cpptools:C++ 插件的 IntelliSense 缓存(单项目可达几百 MB) -
%LocalAppData%\Programs\Microsoft VS Code\Cache:Chromium 内核的通用缓存(含渲染、字体、网络资源) -
%LocalAppData%\Programs\Microsoft VS Code\Code Cache:VS Code 自身的代码索引与预编译缓存(常被忽略但增长极快)
这三处都不会响应 settings.json 或 UI 设置,改配置项无效。
用 --cache-dir 参数重定向通用缓存目录
这是最干净、最推荐的方式,适用于 Cache 和 Code Cache:
- 关闭所有 VS Code 进程(包括后台的
Code Helper) - 右键桌面快捷方式 →「属性」→「快捷方式」选项卡
- 在「目标」末尾添加完整参数(注意空格和引号):
"C:\Program Files\Microsoft VS Code\Code.exe" --cache-dir "D:\VSCode\Cache" - 保存后双击启动,检查新目录下是否生成
Cache和Code Cache子文件夹
⚠️ 注意:--cache-dir 不影响 vscode-cpptools,那个得单独处理。
单独迁移 vscode-cpptools 缓存
C++ 插件的缓存路径由环境变量 VSCODE_CPP_TOOLS_CACHE_PATH 控制,不是启动参数:
- 新建系统环境变量(非用户变量),变量名:
VSCODE_CPP_TOOLS_CACHE_PATH,值设为你的目标路径,例如:D:\VSCode\CppToolsCache - 重启终端或整个系统使变量生效(仅重启 VS Code 不够)
- 首次启动后,插件会在新路径下重建
ipch和mmap_address.bin文件 - 旧路径
%LocalAppData%\Microsoft\vscode-cpptools可手动删除(确认新缓存已生成后再删)
这个变量对其他语言插件(如 Python 的 Pylance)不生效,它们各自有独立缓存机制。
符号链接是兜底方案,但有隐藏风险
当参数或环境变量失效(比如某些第三方工具调用 code 时不传参),就只能靠 mklink 强制重定向:
- 以管理员身份打开 CMD
- 先移动原目录:
move "%LocalAppData%\Programs\Microsoft VS Code\Cache" "D:\VSCode\Cache-orig" - 再建符号链接:
mklink /D "%LocalAppData%\Programs\Microsoft VS Code\Cache" "D:\VSCode\Cache-orig"
⚠️ 风险点:Windows Defender 有时会拦截符号链接创建;部分杀毒软件会报“可疑重定向”;升级 VS Code 后链接可能断裂,需重新执行。除非前两种方法都失败,否则不建议优先用这个。
真正容易被忽略的是:即使你改了所有路径,只要没清空旧缓存,C 盘空间不会立刻释放。删之前务必确认新路径已写入数据——最简单的方法是打开一个 C++ 文件,等右下角状态栏出现 “IntelliSense ready”,再去新路径看有没有生成 ipch 文件夹。


















