离线环境下VSCode的Find All References不可用，主因是语言服务器未预下载、项目配置缺失或插件未激活；需手动拷贝完整插件目录（含node_modules）、补全jsconfig.json/tsconfig.json，并排除大目录以保障索引性能。
离线环境里 VSCode 的引用搜索（Find All References）基本不可用——不是插件没装对，而是底层语言服务器根本起不来，符号索引压根没建。
为什么离线时 Find All References 总是空或不准
VSCode 的引用功能不靠编辑器自己解析，而是依赖语言服务器（LSP）实时构建的符号索引。离线时常见断点：
- 语言服务器二进制未预下载（如
pyright、tsserver、gopls），首次打开文件就卡在 “Starting language server…” - 项目级配置缺失（如
jsconfig.json或tsconfig.json），导致跨文件引用无法识别 - 插件安装了但没激活：离线安装的
ms-python.python或esbenp.prettier-vscode默认禁用，需手动点「启用」并重启 - VSCode 版本与插件
engines.vscode不匹配，package.json 里声明"^1.82.0"，你装的是 1.79 —— 它静默跳过加载，不报错也不提示
离线环境下让引用搜索真正可用的三步
必须绕过“联网下载+自动激活”路径，走全手动装配：
- 在有网机器上，用目标版本 VSCode 打开同类项目，触发一次完整启动：打开 .py 文件 → 等状态栏出现 “Python interpreter selected”；打开 .ts 文件 → 看是否出现类型提示。这会强制下载
pyright或tsserver到~/.vscode/extensions/...下对应插件目录内 - 把整个插件文件夹（不是 .vsix！）拷到离线机相同路径，例如 Linux 下是
~/.vscode/extensions/ms-python.python-2026.4.0/，注意保留dist/和node_modules/子目录 - 补全项目级索引配置：JavaScript 项目加
jsconfig.json，TypeScript 项目确认tsconfig.json里"include"包含源码路径，且不含"exclude": ["node_modules"]这类错误写法（它会把整个node_modules当作代码排除，导致库函数引用失效）
Find All References 响应慢？先关掉这些默认行为
离线环境资源有限，某些 VSCode 默认特性反而拖垮引用性能：
- 关闭
Editor: Suggest Locality Bonus：它会让 VSCode 在每次输入时扫描当前文件变量，离线时无缓存，变成同步阻塞 - 禁用
TypeScript › Suggest: Auto Imports：自动导入需联网查 npm 包名，离线会超时等待，直接拖慢整个建议系统 - 删掉
settings.json里的"typescript.preferences.includePackageJsonAutoImports": "auto"：这是个隐藏耗时项，离线时每打开一个 .ts 文件都尝试读取 package.json 并查依赖 - 确保
"files.exclude"和"search.exclude"排除了node_modules、dist、build—— 否则引用搜索会遍历数万文件，内存爆掉
离线引用能跑起来的关键，从来不是“多装几个插件”，而是把语言服务器的二进制、项目配置、索引范围这三样东西，在断网前就对齐、拷全、压平。少一个环节，Find All References 就只是个灰色按钮。
