VSCode无内置离线缓存机制，需分别处理编辑器本体、插件和Node.js依赖；npm离线安装必须显式指定--cache路径、强制启用--offline、推荐添加--no-package-lock，且缓存须完整预热并避免跨平台拷贝。
VSCode 本身不自带“离线开发缓存”机制，但它的三个核心组件（编辑器本体、插件、Node.js 依赖）各自有独立的缓存路径和离线策略。真正能离线用起来，靠的是分别处理这三块，并且不能指望一键开关。
npm install --offline 为什么总报错 ENOENT 或 getaddrinfo ENOTFOUND
这不是 npm 缓存坏了，是它默认拒绝信任本地缓存。v6+ 版本会强制向 registry.npmjs.org 发起 HEAD 请求校验元数据，断网时直接失败。
-
--offline是必须加的开关，不是可选项；不加它，npm 就会尝试联网 -
--cache必须显式指定路径，比如--cache ./npm-cache，否则它去读系统默认路径（如C:\Users\XXX\AppData\Local\npm-cache），而你拷过来的缓存根本不在那儿 -
--no-package-lock推荐加上，否则package-lock.json里的integrity字段会触发远程签名校验，离线必挂 - 缓存目录必须完整打包——不是只拷
_cacache子目录，而是整个缓存根目录（含index、content-v2、tmp等） - 跨平台拷贝无效：macOS/Linux 的缓存不能直接在 Windows 上用
VSCode 插件离线安装找不到 Download Extension 按钮了怎么办
2025 年初起，VSCode 官方市场已移除页面上的直接下载按钮。现在必须手动拼链接或用工具获取 .vsix 文件。
- 网页方式：访问
https://marketplace.visualstudio.com/items/{publisher}.{name}/versionhistory，手动点每个版本右侧的 “Download” 链接（需浏览器开发者工具抓包或翻页找） - 命令行方式：用
vsce download，例如vsce download ms-python.python --version 2024.12.1 - 第三方源风险高：镜像站版本滞后、无 GPG 签名、甚至重打包，金融/政企环境严禁使用
- 安装时务必关闭 VSCode，否则可能因文件被占用导致扩展目录写入失败
- 验证不能只看是否出现在扩展列表——要打开对应功能（如 Python 的 Jupyter Notebook 启动、调试器连接）确认真实可用
VSCode 终端里 npm install --offline 不生效，是不是配置没生效
VSCode 内置终端（尤其 Windows 下的 PowerShell）默认不继承系统级 npm 配置，PATH 和 cache 设置经常失效。
- 先检查终端启动的是什么 shell：
terminal.integrated.defaultProfile.windows设为cmd或pwsh，别让它自动选错 - 不要依赖全局 npm，改用
npx --no-install npm install --cache ./npm-cache --offline --no-package-lock，绕过 PATH 查找 - 如果项目里用了 pnpm/yarn，它们的离线逻辑和 npm 不同——pnpm 要加
--offline+--config.store-dir，yarn v1 需提前yarn install --offline预热，v4 则默认更激进地缓存 - VSCode Remote-Containers 场景下，Docker 构建阶段的缓存才真正关键：把
COPY package*.json和RUN npm ci放在 Dockerfile 前部，避免每次改代码都重装依赖
最易被忽略的一点：VSCode 插件和 npm 依赖的缓存是完全隔离的，二者无法互相替代。Python 扩展装上了，不代表 python -m pip install 能离线运行；插件能启动，也不代表它依赖的 LSP server（比如 pylsp）的 Node 模块也缓存好了。离线部署必须按层拆解、逐层验证。
