应使用nvm管理Node.js版本并搭配Vite或Webpack Dev Server实现热加载，避免系统自带node；安装nvm后配置~/.zshrc并source，用nvm install --lts启用LTS版；npm设淘宝镜像，启用corepack替代全局yarn；VS Code需确保集成终端加载zshrc。
要在 macos 上配置支持热加载的 node.js 前端测试服务器环境，核心不是“装个 node 就行”，而是搭建一套能自动响应代码变更、即时刷新浏览器、且不干扰开发流程的轻量闭环。关键在于选对工具链、避免系统 node 干扰、并让热更新真正生效——不是靠手动刷新，也不是靠插件堆砌。
用 nvm 管理 Node.js 版本（必须前置）
macOS 自带的 /usr/bin/node 权限受限、无法升级、易与后续工具冲突。直接覆盖或卸载风险高，还可能影响 Xcode 工具链。
- 运行安装命令（以最新稳定版为准）：
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash - 编辑
~/.zshrc（macOS Catalina 及以后默认 shell），追加三行：export NVM_DIR="$HOME/.nvm"<br>[ -s "$NVM_DIR/nvm.sh" ] && \. "$NVM_DIR/nvm.sh"<br>[ -s "$NVM_DIR/bash_completion" ] && \. "$NVM_DIR/bash_completion"
- 执行
source ~/.zshrc，再运行nvm --version确认可用 - 安装并启用 LTS 版本：
nvm install --lts && nvm use --lts
选一个真正开箱热重载的开发服务器
不要自己手写 http-server 或 express + watch 脚本——维护成本高、HMR（模块热替换）支持弱。推荐两个成熟方案：
-
Vite：现代首选。零配置启动，内置 HMR，支持 Vue/React/Svelte 等，静态资源变更秒级生效。
初始化：npm create vite@latest my-app -- --template react→ 进入目录 →npm install→npm run dev，默认打开http://localhost:5173，改代码即刷新 -
Webpack Dev Server + React Refresh：适合已有 Webpack 项目。确保已安装：
webpack-dev-server和@pmmmwh/react-refresh-webpack-plugin，并在 webpack 配置中启用hot: true和插件。启动命令为webpack serve
配置 npm 淘宝镜像与 corepack（保障依赖安装顺畅）
国内网络下，npm 默认源常超时或失败；全局安装的 yarn 容易因 node 版本切换而失效。
Rydberg Agent Node
下载
使用一条命令部署ProbeChain Rydberg测试网代理节点。自动注册为Agent(NodeType=1)，免gas，支持macOS/Linux/Windows。触发词：/r
- 设置 npm 镜像：
npm config set registry https://registry.npmmirror.com - 启用 Node 内置的 corepack（替代全局 yarn）：
corepack enable
验证：which yarn应返回/opt/homebrew/bin/yarn（Apple Silicon）或/usr/local/bin/yarn（Intel），而非~/.npm-global/bin/yarn - 若之前装过全局 yarn，先清理：
npm uninstall -g yarn && rm -f $(which yarn)
VS Code 与终端环境对齐（避免“终端能跑，VS Code 终端报 command not found”）
VS Code 内置终端默认读取 shell 配置（如 ~/.zshrc），但有时未自动加载。常见表现是：终端里 node -v 正常，VS Code 集成终端却提示 command not found。
立即学习“前端免费学习笔记（深入）”；
- 在 VS Code 中打开命令面板（
Cmd+Shift+P），输入并选择Shell Command: Install 'code' command in PATH - 重启 VS Code，或在集成终端中手动执行：
source ~/.zshrc - 检查是否生效：
which node输出应含nvm路径，例如~/.nvm/versions/node/v20.11.1/bin/node
