npm install --offline报ENOTFOUND是因为仍尝试连registry校验元数据，需配合--cache指定完整缓存路径并加--no-package-lock禁用integrity校验。
能离线写代码，但必须提前在有网机器上把缓存“喂饱”，且 VSCode 本身不自动管理这些缓存——它只负责调用 npm、pip、maven 等工具，而这些工具的离线行为全靠你配对参数和路径。
npm install --offline 为什么还是报错 ENOTFOUND？
因为 npm install 默认会连 registry.npmjs.org 做元数据校验，哪怕本地有包也拒绝信任。断网时直接触发 getaddrinfo ENOTFOUND registry.npmjs.org。
-
--offline是开关，但不是万能钥匙：它只禁网络，不指定缓存位置，npm 仍会去默认路径（如/tmp/xxx）找 index.json，结果报ENOENT: no such file or directory - 必须显式传
--cache ./npm-cache，且该目录得是你从有网机拷过来的完整缓存（含_cacache、index、content-v2） - 推荐加
--no-package-lock：避免校验package-lock.json里的integrity字段——这个字段签名依赖远程 registry，离线必挂
正确命令：npm install --cache ./npm-cache --offline --no-package-lock
VSCode 终端里跑不起来？检查这三件事
VSCode 内置终端不继承系统级 npm 配置，尤其 Windows 下 PowerShell 经常找不到 npm。
- 确认终端启动的是
cmd.exe而非 PowerShell；或改设置terminal.integrated.defaultProfile.windows - 不要依赖全局
npm：用npx --no-install npm install --cache ./npm-cache --offline，绕过 PATH 查找 - 确保项目根目录下真有
./npm-cache这个目录，且权限可读——VSCode 不会自动创建它
Python / Java / Go 怎么复用本地缓存？
原理一样：挂载主机缓存目录到容器内对应路径，并告诉工具链去哪读。
- Python：
pip缓存挂载到/root/.cache/pip，并在devcontainer.json中加"mounts"和"remoteEnv": {"PIP_CACHE_DIR":"/root/.cache/pip"} - Java：
maven需把本地~/.m2/repository拷到离线机，再通过settings.xml的<localrepository></localrepository>和<mirror></mirror>指向它 - Go：
go mod download后的$GOPATH/pkg/mod/cache可整体拷贝，容器内设GOENV=off+GOPROXY=direct强制走本地
注意：跨平台缓存不能混用（比如 macOS 的 npm 缓存拷到 Windows 上基本无效）。
devcontainer.json 里怎么写缓存挂载才生效？
挂载只是第一步，还得让工具链“认出”它。VSCode 不会自动改环境变量，必须手动声明。
- 挂载本身用
mounts数组，source必须是主机绝对路径（${env:HOME}或${env:USERPROFILE}可展开） - 关键一步：用
remoteEnv设置对应工具的缓存路径变量，比如"NPM_CONFIG_CACHE":"/home/vscode/.npm" - 别漏掉
consistency=cached（尤其 macOS），否则 bind mount 可能因文件系统差异导致缓存未命中
最易忽略的点：Docker 层缓存和包管理器缓存是两层事——Dockerfile 里 COPY package*.json && RUN npm ci 能复用镜像层，但没挂载 .npm 目录的话，每次重建容器仍会重装包。
