VSCode插件未触发activationEvents是因懒加载机制：仅在声明事件（如onLanguage:python）发生时激活；空窗口、未保存文件等场景下插件不加载，需验证事件条件、检查依赖冲突、确认VSIX完整性及Java项目缓存同步。
插件 activationEvents 没触发，根本没加载
VSCode 不会一启动就把所有插件全拉起来，而是按 package.json 里声明的 activationEvents 来懒加载。比如 onLanguage:python 只在打开 .py 文件时才激活；onCommand:extension.formatOnSave 要等你手动调用那条命令。空窗口、纯文本文件、未保存的 Untitled 标签页，都可能让插件“躺平”不动。
验证方法：打开命令面板（Ctrl+Shift+P），运行 Developer: Toggle Developer Tools，切到 Console 标签页，刷新后看有没有 Activating extension 'xxx' failed 这类报错。再点开插件详情页（插件市场网页或 VSCode 插件面板里的 ⓘ 图标），确认它的 Activation Events 字段到底要什么条件才能动。
- 新建一个匹配语言的文件（如
test.py），保存为对应后缀，再观察插件图标是否变亮 - 如果依赖是
onStartupFinished，说明它本该随 VSCode 启动就加载——此时没反应，大概率是后续某步出错了 - 某些插件要求先执行一条命令（如
Python: Select Interpreter）才能激活，漏掉这步就卡住
插件之间互相覆盖配置，功能静默失效
VSCode 允许不同插件对同一设置项（如 editor.formatOnSave、python.defaultInterpreterPath）做覆盖。后加载的插件会赢，但不会报错、不提示，只默默接管。结果就是：插件明明启用了，但格式化不工作、解释器路径不生效、语言服务器连不上。
排查重点不是“有没有启用”，而是“有没有被顶替”。打开 Preferences: Open Settings (JSON)，搜索插件名（如 @ext:ms-python.python），逐项核对关键配置是否还在你预期的位置，尤其是路径类字段：
-
python.defaultInterpreterPath对应的路径是否存在？文件是否有可执行权限？ -
prettier.path或eslint.packageManager是否指向了真实安装的二进制？ - 禁用其他同类插件（比如同时装了
esbenp.prettier-vscode和esbenp.mdx），再逐个启用测试
手动安装 VSIX 时 node_modules 缺失，直接报 Cannot find module
VSCode 不会帮你跑 npm install。从官网市场安装的插件，作者已把全部依赖打包进 .vsix；但如果你是手动下载 VSIX 安装，就得自己验包。常见错误是压缩包里压根没 node_modules/ 目录，或者只打了部分依赖。
验证方法（macOS/Linux）：unzip -l your-plugin.vsix | grep node_modules；Windows 用户可用 7-Zip 打开 VSIX（本质是 zip），检查根目录下有没有 node_modules 文件夹。缺失就别装了——大概率启动即失败。
补救步骤：
- 卸载插件后，手动清理残留：
~/.vscode/extensions/（macOS/Linux）或%USERPROFILE%\.vscode\extensions\（Windows），删掉对应文件夹（名字含作者和插件名，如ms-python.python-2024.6.0） - 重启 VSCode，改用扩展市场直接安装（避免第三方来源的 VSIX）
- 若必须用 VSIX，优先选插件作者 GitHub Release 页面发布的官方包
Java/Maven 项目里依赖显示红色波浪线，但 mvn compile 成功
这不是代码问题，是 VSCode Java 插件的 dependency graph 缓存和本地 Maven 构建状态不同步。它不读 target/ 或 ~/.m2/ 的实时结果，而是自己维护一套索引。所以即使 mvn compile 成功，VSCode 仍可能报 Cannot resolve symbol。
关键动作不是重装插件，而是强制刷新它的缓存：
- 确保在**父
pom.xml所在目录**下打开整个工作区（不能只开子模块文件夹） - 执行
mvn clean compile后，再运行命令Java: Clean the Java language server workspace - 接着右键点击
pom.xml→Import Maven Project（如果右键没这个选项，说明 Java 扩展根本没激活，先检查java.home设置） - 确认设置中
java.configuration.updateBuildConfiguration是interactive，不是disabled
多模块项目里，父子 POM 路径关系和缓存刷新时机，比配置本身更容易被忽略。
