离线环境智能提示失效的根本原因是语言服务器未加载类型定义或文档索引。需依次补全三项：类型定义包（如@types/vue）、语言配置文件（tsconfig.json或pyrightconfig.json）、VSCode设置，并手动重启语言服务。
离线环境里智能提示文档（如函数参数、返回值、注释）不会自动出现，根本原因是语言服务器没加载类型定义或文档索引——不是插件没装，是服务没跑起来。
为什么 Ctrl+Hover 没文档、F12 跳转失败
常见现象：装完 Volar 或 Pylance 后，ref()、useState()、np.array() 一 hover 就只有“any”或空白弹窗，F12 提示“no definition found”。这不是插件问题，而是语言服务器压根没拿到类型文档源。
-
Volar需要@vue/language-core+@types/vue才能解析defineProps的注释；只装 .vsix 不管用 -
Pylance默认不加载第三方包 docstring，必须有本地pyrightconfig.json或pyproject.toml显式启用include路径 - 状态栏右下角显示 “Vue (Volar)” 但无文档 → 说明语言模式已切换，但 TS/JS 服务未加载类型库，
tsconfig.json缺"types": ["vue"]或node_modules/@types/vue根本不存在
离线必须补全的三项文档依赖
缺一不可，且顺序不能乱：先有类型定义，再有配置文件，最后才轮到 VSCode 设置生效。
- 类型定义包：
@types/vue（Vue 3）、@types/node（Node.js）、numpy-stubs（Python）——必须在联网机npm install --save-dev @types/vue或pip install numpy-stubs，然后把整个node_modules/@types或site-packages/numpy_stubs拷进离线项目 - 语言配置文件：
tsconfig.json（Vue/TS）需含"include": ["src/**/*", "src/**/*.vue"]和"types": ["vue"]；pyrightconfig.json（Python）需设"include": ["./src"]和"reportMissingTypeStubs": false -
.vscode/settings.json中强制启用文档提示："editor.hover.enabled": true、"editor.quickSuggestions": {"other": true}、"typescript.preferences.includePackageJsonAutoImports": "auto"
手动触发文档加载的关键动作
装完依赖后，VSCode 不会自动重载语言服务——你得“逼它一把”：
- 打开任意一个目标文件（如
App.vue或main.py），按Ctrl+K Ctrl+M再选一次语言模式（哪怕当前已是 Vue/Python），强制重置语言服务绑定 - 按
Ctrl+Shift+P输入Developer: Restart Language Server并执行（对Volar、Pylance、C/C++都有效） - 观察
Output面板 → 切换到对应通道（如Vue Server或Pylance），看到Starting language server且无Failed to fetch才算真正就绪 - 若仍无文档，临时删掉
node_modules/.cache或~/.cache/Pylance目录，重启 VSCode —— 离线环境下缓存损坏极难察觉，但会导致类型索引静默跳过
最常被忽略的一点：文档提示高度依赖首次启动时的语言服务器初始化。如果第一次打开文件时网络不通、类型路径错、或 tsconfig.json 里 include 漏了 .vue 后缀，后续所有 hover 都只会返回空结果——此时删缓存 + 重启语言服务比重装插件更有效。
