VSCode离线文档无统一自定义存储路径，因其由各插件独立管理；仅少数插件（如cpptools）支持配置缓存路径，多数需通过重装插件并指定--user-data-dir间接迁移。
VSCode离线文档（如内置API参考、语言服务器文档）不支持自定义存储路径
VSCode本身没有提供配置项或命令行参数来指定“离线文档”的存放位置。所谓离线文档，比如 TypeScript 的 lib.d.ts、Python 的 python-docs（来自 ms-python.python 插件）、或 C/C++ 的 cpptools 内置符号数据库，它们的缓存行为由对应插件自行控制，不是 VSCode 主进程统一管理的。
这意味着：你找不到类似 --docs-dir 这样的参数；设置 user-data-dir 或 extensions-dir 也不会让这些文档自动迁移过去——它们可能散落在插件目录、系统临时文件夹，甚至嵌入在插件二进制包里。
哪些“离线文档”实际可被移动？看插件是否显式暴露缓存路径
只有少数插件把文档缓存做成可配置的独立目录。典型例子：
-
ms-python.python：会把 Python 标准库文档（pydoc输出缓存、pyright类型stub）存在%USERPROFILE%\.vscode\extensions\ms-python.python-*/pythonFiles\lib\python下，但该路径硬编码在插件代码中，无法通过设置修改 -
ms-vscode.cpptools：C++ IntelliSense 缓存（ipch、sqlite数据库）默认写入项目根下的.vscode/pidb或系统临时目录（如%TEMP%\vscode-cpptools），可通过插件设置cpp.default.intelliSenseCachePath指定 -
redhat.vscode-yaml或esbenp.prettier-vscode：基本不存离线文档，依赖在线 schema 或运行时解析
所以，真要腾出 C 盘空间，重点不是“改文档路径”，而是查清具体哪个插件在写大文件，再针对性处理。
检查和清理离线文档类缓存的实际方法
别猜，直接定位真实占用源：
- 打开 VSCode，按
Ctrl+Shift+P，运行Developer: Open Logs Folder，看看日志里有没有插件反复写入某路径的线索 - 用工具（如
WinDirStat或TreeSize Free）扫描%USERPROFILE%\.vscode\extensions下各插件子目录，排序看哪个体积异常（例如ms-python.python-2026.10.0文件夹超 800MB，大概率含文档缓存） - 检查系统临时目录：
%TEMP%和%LOCALAPPDATA%\Temp，搜索关键词vscode、cpptools、pyright，常有未清理的文档索引文件 - 某些插件（如
ms-dotnettools.csharp）会把 Roslyn 缓存放在%USERPROFILE%\.omnisharp，这不是 VSCode 路径，但属于配套工具链，需单独迁移
发现目标后，不要直接删——先关掉 VSCode 和所有相关后台进程（Code Helper.exe、dotnet.exe、python.exe），再移动或清空。
唯一能全局影响“文档类缓存”的间接手段：改 --user-data-dir 并重装插件
虽然不能指定文档路径，但你可以让整个用户数据环境（含插件安装时产生的所有缓存）落到非系统盘。前提是：
- 彻底退出 VSCode（任务管理器确认无残留进程）
- 用命令启动：
code --user-data-dir "D:\VSCodeUserData" --extensions-dir "D:\VSCodeExtensions" - 重装关键插件（如 Python、C++），它们会在新
extensions-dir下重建缓存结构，部分插件会把文档缓存也一并写到扩展目录内 - 验证：打开一个 Python 文件，触发
Go to Definition，再检查D:\VSCodeExtensions\ms-python.python-*/下是否有新增的lib或stubs子目录
注意：这招对纯在线文档（如 Volar 的 Vue API）无效；对已存在的旧插件缓存也不自动迁移，必须重装。
真正难搞的从来不是路径配置，而是不同插件各自为政的缓存策略——没有统一标准，就得一个一个查、一个一个试。
