确认三个版本
请只检查 node --version、npm --version、npx --version，并告诉我每条命令的真实结果，不要安装或升级。
验证结果三个版本号，或明确指出失败的那一条。先把电脑环境准备好
安装一次 Node.js LTS，就会同时得到后续教程需要的 Node.js、npm 和 npx。跟着当前电脑系统操作，最后用三个版本号确认成功。
- 预计时间
- 10 分钟
- 完成后你会看到
- node、npm、npx 三条版本命令都返回版本号。
开始前准备
- 一台 Windows 或 macOS 电脑
- 可以下载安装软件
- 安装时能确认系统弹出的权限提示
只安装一项，就能得到三个工具
Node.js 是运行环境，npm 负责安装软件包，npx 负责直接运行安装器。安装受支持的 Node.js LTS 后，npm 和 npx 会一起出现，不需要分别下载。
这篇教程不要求你学习编程。最终只需看到三个版本号。
看到这个就成功你知道只需安装 Node.js LTS，不会另外寻找 npm 或 npx 安装包。
如果没有成功如果某个教程让你分别下载 npm 或 npx，请先停下，回到本页按一条完整路线操作。
最省心：让 AI 检查并补齐环境
如果你的 AI 能在本机执行命令，把下面这句话直接发给它。它会先检查，已经可用就不会重复安装。
请 AI 准备电脑环境
请帮我准备后续 Yeelight AI 教程需要的电脑环境。先检查 Node.js、npm 和 npx；三项都能运行就不要重装。缺少时请为我的系统安装当前 Node.js LTS，只使用 Node.js 官方来源或系统自带的软件安装工具，不要顺便安装其他开发工具。安装后请重新打开命令窗口，分别运行 node --version、npm --version、npx --version，并把真实结果告诉我。如果需要我点击安装器或确认权限，请停下来清楚告诉我该点哪里。不要索要账号、密码、Token，也不要永久修改 npm 下载源。
这里只准备公开运行环境，不需要接触 Yeelight 账号或家庭。 脱敏交互演示，不会读取你的家庭或控制设备。
看到这个就成功AI 返回三个真实版本号，而不是只说“已经安装”。
如果没有成功如果 AI 不能执行本机命令，继续下一步，按系统手动安装。
自己安装：选择当前系统的单一路线
零基础用户优先打开 Node.js 官方下载页，选择 LTS 和系统安装器：macOS 使用 .pkg，Windows 使用 .msi。命令块右上角的问号会告诉你命令在哪里运行。
官方安装器最直观。只有已经在使用 Homebrew 或确认 WinGet 可用时，才需要复制下面的命令。
brew --versionbrew install node@24 && brew link --force node@24第一条能显示 Homebrew 版本时，才运行第二条。如果提示已有同名链接，不要添加 --overwrite；先检查现有 Node.js，或改用上方官方 .pkg。
winget --versionwinget install --id OpenJS.NodeJS.LTS --exact第一条能显示版本时，才运行第二条。找不到 winget 就使用上方 Node.js 官方 .msi。
只从 Node.js、Homebrew、Microsoft 官方来源或明确标注的第三方镜像下载；不要关闭证书检查。
看到这个就成功系统安装器或包管理器显示安装完成，没有要求你另外安装 npm 或 npx。
如果没有成功安装包不知道选哪个时：Apple 芯片 Mac 选 ARM64，Intel Mac 选 x64；Windows 在“设置 > 系统 > 系统信息”查看系统类型。仍不确定就使用 Node.js 下载页默认推荐项。
重新打开命令窗口，逐条验证
安装完成后关闭旧的终端或 PowerShell，再重新打开一次，让新路径生效。下面三条命令一次只复制一条。
node --versionnode --version
交互演示，不会在你的电脑上执行命令，也不会连接设备。
npm --versionnpm --version
交互演示，不会在你的电脑上执行命令，也不会连接设备。
npx --versionnpx --version
交互演示，不会在你的电脑上执行命令，也不会连接设备。
看到这个就成功三条命令都返回版本号。数字不必和示例完全一样，npm、npx 与 Node.js 的版本号也不需要相同。
如果没有成功先确认已经关闭旧命令窗口并重新打开。Windows 仍失败时检查 where.exe node，macOS 检查 command -v node；不要连续安装多个 Node.js。
验证你的电脑环境
先确认三个版本号。遇到问题时，再选择下面对应的话发给你的 AI 排查。
只补齐缺少的部分
请先检查电脑环境。只有 Node.js、npm 或 npx 缺失时才安装当前 Node.js LTS，完成后再验证三条版本命令。
验证结果不会重复安装，最后有三个真实版本号。查清命令实际位置
请检查 Node.js、npm 和 npx 在这台电脑上的实际位置，判断是否有重复安装或 PATH 冲突，先告诉我结论，不要删除任何东西。
验证结果命令位置、是否重复，以及安全的下一步。更多环境检查
检查 Windows 的 WinGet
请检查这台 Windows 是否有 WinGet。没有时告诉我如何用官方 Node.js LTS 的 MSI 安装，不要让我永久修改 PowerShell 安全策略。
验证结果WinGet 可用性与官方安装回退。确认电脑架构
请检查这台电脑是 Apple Silicon、Intel、Windows x64 还是 Windows ARM64，并告诉我该选哪个 Node.js LTS 安装包。
验证结果与电脑匹配的安装包类型。排查下载或证书问题
Node.js 下载或安装失败了。请检查网络、代理、系统时间和证书提示，优先给我官方来源或可信国内镜像，不要关闭 TLS 或证书验证。
验证结果保留安全边界的下载恢复步骤。遇到问题
安装 Node.js 后，npm 和 npx 会一起出现吗？
会。受支持的 Node.js LTS 安装包会同时提供 npm；现代 npx 是 npm 自带的运行入口，不需要分别下载。
电脑已经能显示三个版本号，还要重新安装吗？
不用。三条命令都能返回版本号时直接完成本教程，避免重复安装造成 PATH 冲突。
安装后仍提示找不到 node、npm 或 npx，先做什么？
关闭所有旧终端或 PowerShell，再打开一个新窗口重试。安装器修改的 PATH 通常只会在新窗口里生效。
Windows 没有 winget 怎么办？
不用卡在这里。直接从上方 Node.js 官方下载页获取 LTS 的 Windows Installer（.msi）并安装；也可以从 Microsoft Store 更新 App Installer 后再试 winget。
Windows 为什么会找到多个 Node.js？
先运行 where.exe node 查看所有位置，不要继续重装。保留一个明确使用的版本，再让懂系统配置的人协助清理旧 PATH；本教程不会自动删除任何版本。
PowerShell 提示 npm.ps1 被执行策略阻止怎么办？
先运行 npm.cmd --version；如果能返回版本，说明 npm 已安装，也可以改用“命令提示符”完成后续命令。不要为了这一条命令把整个系统永久设为 Unrestricted。
macOS 一定要安装 Homebrew 吗？
不需要。零基础用户直接使用 Node.js 官方 LTS 的 macOS Installer（.pkg）更直观。Homebrew 只是一条给现有 Homebrew 用户的可选路线。
macOS 安装完成后仍找不到命令怎么办？
完全退出“终端”再打开，运行 command -v node。没有结果时重新运行官方 .pkg 并保留默认安装位置，不要在多个包管理器之间反复安装。
Apple Silicon、Intel、x64、ARM64 应该怎么选？
带 M 系列芯片的 Mac 是 Apple Silicon/ARM64，旧款 Intel Mac 选 x64。Windows 可在“设置 > 系统 > 系统信息”的“系统类型”中查看 x64 或 ARM64。
npm、npx 和 Node.js 的版本号不一样正常吗？
正常。它们是不同工具，版本号不需要相同；npm 和 npx 通常会显示相同或接近的 npm 版本。
下载很慢、超时或提示证书错误怎么办？
先检查系统时间和公司代理。官方页面慢时可使用本页明确标注的国内第三方镜像，但不要关闭 TLS、忽略证书错误或从不明网盘下载安装包。
安装时需要管理员权限或 sudo 吗？
官方 .pkg/.msi 可能会弹出系统权限确认，这是正常的；确认发布者后按系统提示操作。不要给 npm 命令随意加 sudo，也不要把电脑密码发给 AI。
关注易来，继续探索
获取产品动态、智能照明灵感与 Yeelight AI 的最新实践。选择你常用的平台，扫码关注或直接访问。
微信公众号
Yeelight 易来
关注官方公众号，获取产品更新、使用指南与智能照明内容。
使用微信扫码关注。 抖音
Yeelight 易来
观看易来产品、空间光影与智能照明的短视频内容。
使用抖音扫码关注。
腾讯视频号
姜兆宁 Yeelight 易来
关注易来 CEO 的家居视频号，了解智能照明与真实家庭空间。
使用微信扫码关注视频号。