VSCode离线文档功能不依赖缓存大小设置，而是依赖TypeScript SDK内置声明文件及node_modules中types包的完整性；需确保安装typescript和对应@types包，并正确配置TS版本与类型路径。
VSCode离线文档不依赖“缓存大小”设置
VSCode 本身没有“离线文档缓存大小”这个配置项。你看到的文档补全、悬停提示（比如 Array.prototype.map 的签名和说明），来自 TypeScript 语言服务内置的声明文件（.d.ts），不是从网络下载后缓存在本地磁盘的 HTML 页面。这些类型定义随 TypeScript SDK 一起打包进 VSCode 或项目中，无需额外缓存空间管理。
真正影响离线文档体验的是 TypeScript Server 和 node_modules
离线环境下，hover、go to definition、intellisense 能否正常工作，取决于：
- 当前工作区是否已安装
typescript包（node_modules/typescript）——它自带完整lib.es202X.d.ts等标准库声明 - VSCode 是否使用了工作区本地的 TS 版本（检查右下角状态栏，点击可切换为 “Use Workspace Version”）
- 若项目用了
@types/node、@types/react等，这些也必须已存在于node_modules中，且未被npm prune --production清掉
没有网络时，VSCode 不会尝试拉取任何远程文档；但若缺失对应 @types 包，悬停就只显示 any 或空白。
别被“Cache”目录误导：删它不影响离线文档
很多人误以为清理 %APPDATA%\Code\Cache 或 ~/.cache/Code 会影响文档功能，其实不会。这个目录是 Chromium 渲染进程的 HTTP 缓存，只用于 Marketplace 页面、扩展图标、设置页 UI 加载等——和 TypeScript 补全完全无关。
真正该检查的是：
-
node_modules/typescript是否存在且版本 ≥ 4.5（推荐 ≥ 5.0） -
node_modules/@types下是否有你需要的类型包（如@types/node） - 打开命令面板（
Ctrl+Shift+P），运行Developer: Toggle Developer Tools，看 Console 里有没有Could not find a declaration file报错
内网部署时唯一要预置的“文档资源”
如果你用的是自定义构建的 TypeScript 或私有库，需要让离线环境也能跳转定义，就得提前把对应 .d.ts 文件或 types 字段指向的目录，一并拷入项目或 node_modules。VSCode 不会自动发现或缓存它们——它只认 node_modules 结构和 tsconfig.json 中的 typeRoots / types 配置。
换句话说：离线文档不是靠“设缓存大小”启用的，而是靠“把声明文件放对位置”实现的。路径不对、包没装、TS 版本太老，哪怕磁盘空出 100GB 也没用。
