安装 Node.js 和 npm

完成标准

• node --version 不低于 v22.19.0。
• npm --version 能显示版本。
• npm config get registry 显示 https://registry.npmmirror.com/。

Node.js 是 Pi 和 Pi Web 的共同前提。npm 会随 Node.js 一起安装，不需要单独下载。

Windows

1. 打开 Node.js 国内镜像目录。
2. 普通 Intel/AMD 电脑下载 node-v22.19.0-x64.msi；Windows ARM 电脑下载 node-v22.19.0-arm64.msi。
3. 双击安装，保持默认选项。安装完成后关闭并重新打开 PowerShell。
4. 运行：

node --version
npm --version
npm config set registry https://registry.npmmirror.com
npm config get registry

如果 npm 提示 PowerShell 脚本策略错误，以当前用户执行：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

执行后重新打开 PowerShell，再运行完成标准中的三个检查。

macOS

两种方式二选一。先确认有没有 Homebrew：Terminal 运行 brew --version，显示版本号就是有，提示 command not found 就是没有。大部分同学没有，直接用第一种。

没有 Homebrew（图形安装，推荐）

1. 打开 Node.js 国内镜像目录。
2. 下载 node-v22.19.0.pkg，双击并按提示安装。
3. 系统如要求确认安装或输入 macOS 密码，由学员本人在电脑上完成，不要把密码发给 AI。
4. 关闭并重新打开 Terminal。

有 Homebrew（命令行）

brew install node@22

node@22 是 keg-only，安装完 Homebrew 会打印一行把它写入 PATH 的命令（形如 export PATH="/opt/homebrew/opt/node@22/bin:$PATH"），按提示执行后关闭并重新打开 Terminal。国内网络下如果 brew 下载很慢，改用上面的图形安装。

两种方式装完都要执行

node --version
npm --version
npm config set registry https://registry.npmmirror.com
npm config get registry

常见问题

安装后仍提示找不到 node

先关闭所有终端并重新打开，不要立即手工修改 PATH。仍然找不到时，再让 AI 检查当前用户的 PATH 和 Node 安装目录。

版本低于 22.19.0

说明电脑调用的可能是旧 Node。运行 where.exe node（Windows）或 command -v node（macOS），确认实际路径后再处理旧版本优先级。

国内镜像打不开

记录错误，不要从不明软件下载站下载安装包。可以换网络后重试，或在老师确认后使用 Node.js 官方来源。