离线环境下VSCode自动补全需手动配置语言服务、启用python.analysis.autoImportCompletions和typescript.suggest.autoImports、安装匹配版本.vsix插件、配置pyrightconfig.json/jsconfig.json，并关闭localityBonus等干扰项。
离线环境里 VSCode 的自动补全、智能引用和自动导入不是“开箱即用”，必须手动补全语言服务依赖、校验插件兼容性、并显式启用关键配置项，否则 import 不弹、useState 不提示、require 不补全——这些都不是 bug，是配置缺失。
离线安装 Python 插件后自动导入不生效？检查 Pylance 和 autoImportCompletions
VSCode 离线安装 ms-python.python 后，import numpy as np 这类语句不会自动补全，根本原因常是 Pylance 未启用或配置被忽略。
-
python.analysis.autoImportCompletions必须设为true（默认是false）；仅靠editor.quickSuggestions开启没用 - Pylance 是独立扩展，
ms-python.python包含它但不默认激活；需确认ms-python.pylance的 .vsix 已一并下载并成功安装（查看Developer: Show Running Extensions） - 离线环境下，Pylance 需要本地类型索引：确保项目根目录有
pyrightconfig.json或pyproject.toml，否则无法推导第三方包符号 - 别用
python.defaultInterpreterPath指向不存在的虚拟环境路径——离线机器上解释器路径错会导致整个语言服务静默失败
JavaScript/TypeScript 自动导入失效？jsconfig.json 或 tsconfig.json 缺失是主因
写 React.useState 没灯泡、没自动 import，90% 情况下不是插件问题，而是项目缺少类型解析配置文件。
- 纯 JS 项目必须有
jsconfig.json，哪怕只写最简内容：{ "compilerOptions": { "baseUrl": ".", "allowSyntheticDefaultImports": true }, "include": ["**/*.js"] } - TypeScript 项目若
tsconfig.json中include路径没覆盖源码目录（如漏掉"src/**/*"），import补全会退化为纯字符串匹配 -
typescript.suggest.autoImports和javascript.suggest.autoImports必须显式设为true；VSCode 1.85+ 默认仍为false以降低资源占用 - 离线时无法从 npm registry 获取类型声明，
@types/react等需提前npm pack并手动复制到node_modules/@types
离线安装 .vsix 插件失败？先过三关：签名、版本、PATH
Extension is not a valid VS Code extension 这类报错，不是文件名后缀问题，而是结构或环境链断裂。
- 用
unzip -t your-extension.vsix校验压缩完整性；浏览器下载中断、杀毒软件拦截重命名（如变成.vsix.zip）都会导致校验失败 - 打开 .vsix 解压后的
package.json，确认"engines": { "vscode": "^1.85.0" }中的版本号 ≤ 你本地 VSCode 版本（查Help > About）；高版本插件在低版本 VSCode 上直接拒载 -
code --install-extension命令报command not found，不是命令错，是 CLI 未注入 PATH：重启 VSCode →Ctrl+Shift+P→ 输入Shell Command: Install 'code' command in PATH→ 再执行 - 某些插件（如 ESLint、Prettier）依赖 Node.js 运行时，离线环境需提前部署对应版本的
node可执行文件，并在设置中用eslint.runtime等字段硬编码路径
自动补全响应慢或建议不准？关掉 locality bonus 反而更稳
离线环境没有云端模型兜底，Editor: Suggest Locality Bonus 开启后，VSCode 会优先推荐当前文件中出现过的变量名，结果常把 res 推到顶部，而真正需要的 response 被压到第 5 页。
- 关闭
editor.suggest.localityBonus，让语言服务器基于类型定义排序，而非文本频率 - 禁用
editor.wordBasedSuggestions：离线时词频统计无意义，且易与真实符号混淆（比如输use，它推useState还是useEffect全看历史输入，不可控） - 对 Python，
python.languageServer设为Pylance（非Default）；后者在离线时几乎不提供跨文件跳转和导入建议 - 大型项目务必启用
files.watcherExclude排除node_modules/**和__pycache__/**，否则文件监听吃满 CPU，补全延迟飙升到 2s+
离线环境里，所有“智能”都建立在本地可验证的静态信息之上——类型定义、路径配置、插件版本、CLI 可用性。少一个环节，整条链就断；但只要每个点都亲手验过，它比在线环境更稳定、更可预期。
