vscode插件报“module not found”是因插件自身node_modules缺失依赖，而非项目环境问题；需在插件根目录执行npm install安装其package.json声明的dependencies，并确保vsce package前已正确打包，调试时program路径和node_path配置也须准确。

VSCode 里 node -v 能跑，但插件报 module not found

说明 Node.js 环境本身没问题，但插件的依赖没装进它自己的 node_modules。VSCode 插件不是复用你项目里的依赖，而是独立打包的——package.json 里声明的 dependencies 必须在插件目录下执行 npm install 才会生效。

常见错误现象：

• 插件启用后控制台报错 Error: Cannot find module 'axios' 或类似信息
• 插件功能按钮灰掉、右键菜单不出现、状态栏图标不显示
• npm ls axios 在插件根目录下返回空，但在项目根目录能查到

实操建议：

Rydberg Agent Node

使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r

下载

• 打开插件开发目录（不是你的业务项目，是插件源码所在文件夹）
• 终端运行 npm install，确保所有 dependencies 安装完成
• 检查 node_modules 是否存在且包含所需包（如 @dify/plugin-core、axios）
• 打包前务必运行 vsce package，它不会自动帮你装依赖，只打包已存在的 node_modules

为什么 npm-check 检不出插件的依赖问题

npm-check 默认扫描当前工作目录下的 package.json 和 node_modules，但它不理解 VSCode 插件的运行上下文——插件调试时走的是 VSCode 自己的扩展主机进程，加载路径和普通 Node.js 项目不同。

实操建议：

• 别依赖 npm-check --unused 检查插件依赖，它会把真正需要的 dependencies 当成“未使用”
• 想验证是否漏装，直接在插件目录下运行 node -e "require('axios')" 或 node -e "require('@dify/plugin-core')"
• 对 devDependencies（如 vscode-test）可放心用 npm-check，但它们不影响插件运行时行为

launch.json 配置正确，但调试时仍提示找不到依赖

这通常是因为调试启动时没走插件自己的 node_modules，而是用了全局或父项目的环境。VSCode 插件调试默认不自动注入 node_modules 路径，尤其当 program 指向的是入口 JS 文件而非 extension.js 时容易出错。

实操建议：

• launch.json 中的 program 必须指向插件真正的入口，通常是 ${workspaceFolder}/src/extension.js 或 ${workspaceFolder}/out/extension.js（编译后）
• 确保 env 区域没误加 NODE_PATH，它会干扰模块解析顺序
• 如果用了 TypeScript，确认 outDir 和 sourceMap 配置正确，否则断点可能打在未编译文件上，导致依赖加载路径错乱
• 调试前手动运行 npm run compile（或 npm run watch），避免因代码未构建导致 require 路径失效

插件依赖里有 python-shell，但本地 Python 没生效

python-shell 是纯 JS 封装，不自带 Python 解释器。它依赖系统 PATH 中能找到 python 或 python3 命令，且版本需匹配插件要求（如 Python 3.9+）。VSCode 集成终端有时继承的是 shell 启动时的 PATH，而 GUI 启动的 VSCode 可能看不到你 .zshrc 里设的 PATH。

实操建议：

• 在插件代码中加一行 console.log(require('child_process').execSync('which python3').toString().trim())，确认调试时实际调用的是哪个 Python
• 不要只靠终端里 python3 --version 成功就认为 OK，要确保 VSCode 进程能访问同一路径
• 若必须指定解释器路径，在插件初始化时显式传入 options.pythonPath，例如 new PythonShell('script.py', { pythonPath: '/usr/local/bin/python3' })
• Windows 用户注意：安装 Python 时务必勾选 Add Python to PATH，否则即使安装了也找不到

依赖打包和运行时加载是两件事。很多问题不是“没装”，而是“没装对地方”或“没被正确引用”。插件的 node_modules 必须跟它的 package.json 在同一目录层级，且不能靠软链接或跨目录引用——VSCode 打包器不处理这些。