必须先确认 node -v 和 npm -v 能在 VSCode 终端直接运行，否则说明系统 PATH 未生效或安装时未勾选“Add to PATH”，需用 where node/where npm 验证路径并手动添加 Node.js 安装目录至系统环境变量，且 VSCode 必须完全重启才能加载新 PATH。
确认 node -v 和 npm -v 能在 VSCode 终端里直接运行
这是整个流程的起点。如果 node -v 或 npm -v 在 VSCode 内置终端报“不是内部或外部命令”，说明系统 PATH 没生效，或者安装时没勾选“Add to PATH”。不要依赖 Windows 图形化安装界面的“自动配置 PATH”选项——它在某些 Win10/Win11 版本下会失效。
- 打开 CMD，执行
where node和where npm，确认路径是否指向你安装的 Node.js 目录（比如C:\Program Files\nodejs\） - 如果没结果，手动把 Node.js 安装目录加到系统环境变量
PATH里（不是用户变量） - VSCode 必须**完全重启**才能读取新的 PATH —— 关掉所有窗口，再打开，否则终端仍看不到命令
用 npm init -y 初始化项目并安装 webpack-cli
webpack 本身不带命令行接口，必须装 webpack-cli 才能跑 npx webpack 或 npx webpack serve。只装 webpack 会导致执行时报错：Command 'webpack' not found。
- 在 VSCode 终端中进入空文件夹，运行
npm init -y（生成package.json） - 执行
npm install --save-dev webpack webpack-cli（注意是--save-dev，不是全局安装） - 验证：运行
npx webpack --version，应输出版本号；若提示“找不到 webpack”，说明webpack-cli没装或拼写错误
创建最简 webpack.config.js 并配好 entry/output
Webpack 5+ 默认有零配置模式，但一旦你写了 webpack.config.js，就必须显式声明 entry 和 output，否则会报错：configuration.entry should be non-empty object。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 在项目根目录新建
webpack.config.js，内容至少包含：
const path = require('path');
module.exports = {
entry: './src/index.js',
output: {
path: path.resolve(__dirname, 'dist'),
filename: 'bundle.js'
}
};
entry 路径必须存在，且是相对路径（不能用 ./src/index.ts 除非你配了 loader）output.path 必须是绝对路径，用 path.resolve() 构造，否则启动失败module.exports = { ... }，ESM 格式（export default）在默认配置下不被识别在 VSCode 里用 tasks.json 启动 webpack serve
直接在终端敲 npx webpack serve 没问题，但想用 VSCode 的 Ctrl+Shift+B 快捷键触发构建，就得配 .vscode/tasks.json。否则点“运行任务”会提示“没有可运行的任务”。
- 按 Ctrl+Shift+P → 输入 “Tasks: Configure Task” → 选 “Create tasks.json from template” → 选 “Others”
- 替换生成的
tasks.json内容为：
{
"version": "2.0.0",
"tasks": [
{
"label": "webpack serve",
"type": "shell",
"command": "npx webpack serve --mode development",
"group": "build",
"presentation": {
"echo": true,
"reveal": "silent",
"focus": false,
"panel": "shared",
"showReuseMessage": true,
"clear": false
}
}
]
}
"panel": "shared" 很关键：避免每次运行都开新终端面板，复用同一个；否则日志刷屏、端口冲突、热更新失效http://localhost:8080，不是 http://127.0.0.1:8080 —— Webpack Dev Server 默认只绑定 localhost真正卡住人的地方往往不是语法或插件，而是 PATH 没生效、webpack-cli 漏装、output.path 写成相对路径、或者 tasks.json 里没设 "panel": "shared" 导致热更新断连。这些点不试一遍，光看文档很难意识到它们是必填项。
