VSCode本身不管理依赖，只调用本地包管理器并依赖其环境配置；“缺少依赖”提示多因环境错位或工具链未就绪，需检查终端PATH、工作区根路径及语言服务器解析逻辑三处链路。
VSCode 本身不管理依赖，它只调用你本地的包管理器（npm、pnpm、pip、mvn 等）并依赖其输出和环境配置来识别、跳转、补全。所谓“缺少依赖项”的提示，90% 是环境错位或工具链未就绪导致的假警报，不是 VSCode 的 bug，而是信号——某条链路断了。
终端里 npm install 找不到命令
这不是 VSCode 故意屏蔽，而是它的集成终端没加载你的 shell 初始化文件（比如 ~/.zshrc 或 $PROFILE），PATH 里压根没有 npm 或 pnpm 路径。
- 先在系统终端（不是 VSCode 里）运行
which npm或where npm（Windows），确认已安装 - macOS/Linux：检查
~/.zshrc是否包含类似export PATH="$HOME/.nvm/versions/node/v18.17.0/bin:$PATH"的行 - Windows PowerShell：确保
$env:PATH包含 Node.js 安装目录（如C:\Program Files\nodejs\） - VSCode 必须用命令行启动：
code .，而非 Dock/开始菜单——否则继承不到 shell 环境
import 报红但代码能跑
运行靠 Node.js 或 Python 解析器，跳转和提示靠语言服务器（TS Server / Pylance / Java Extension）。两者解析逻辑不同，所以“能执行”和“能识别”经常脱节。
- TypeScript 项目：检查
tsconfig.json中是否启用"composite": true，且"paths"映射正确指向 workspace 内其他包 - Python 项目：右下角状态栏点 Python 解释器路径，确认是
./venv/bin/python（macOS/Linux）或.\venv\Scripts\python.exe（Windows），不是系统 Python - Java 项目：右键
pom.xml→ “Reload project”，别等自动同步——VSCode 不监听文件变更
pip install 在 VSCode 终端生效，但调试仍报 ModuleNotFoundError
因为 VSCode 调试器用的是 launch.json 或 settings.json 里硬编码的解释器路径，和你终端当前激活的环境不是同一个。
- 打开
.vscode/settings.json，确认有"python.defaultInterpreterPath": "./venv/bin/python"（路径需绝对或项目内相对） - 在
.vscode/launch.json的 configuration 中显式写入"python"字段，值为同上路径 - 别信终端里
source venv/bin/activate—— 调试器不会执行这行，它只认配置 - 验证方式：在调试器里加一行
import sys; print(sys.executable)，看输出路径是否和设置一致
离线环境插件功能残缺（如 Python 补全失效）
VSCode 插件（如 ms-python.python）常依赖运行时下载二进制组件（如 pylance、debugpy），离线时这些组件根本没装上，不是插件没启用，而是核心能力缺失。
- 联网机器上手动下载完整依赖链：
ms-python.python→ms-python.pylance→ms-python.debugpy（版本需匹配） -
debugpy是 Python 包，需用目标解释器安装：./venv/bin/python -m pip install debugpy - 插件安装后，重启 VSCode 并打开开发者工具（
Help → Toggle Developer Tools），看 Console 是否有Failed to fetch日志 - 企业级离线部署建议建内部 VSIX 镜像站，配合
code --install-extension xxx.vsix批量安装
最常被忽略的不是“怎么装”，而是“装给谁用”——Node.js 的 node_modules、Python 的 venv、Java 的 ~/.m2/repository，三者互不感知。VSCode 只是窗口，背后每个生态都有自己的根目录、路径规则和缓存机制。配错一个路径，所有提示都会失真。
