症状：终端提示 node 或 npm 不可用，课程项目还跑不起来。
最快解法：先确认课程指定版本；没有指定时，优先安装仍处于 LTS 的 Node.js 24，再检查版本并运行一个最小项目。
适合第一次学 JavaScript、还没在 Mac 上安装 Node.js 的学生；也适合要核对课程项目环境，或在学校管理电脑上寻找合规替代方式的初学者。
SECTION 01Node.js 24 Mac 安装：先确认版本和设备权限
Node.js 是运行 JavaScript 程序的环境，可以把它想成让作业“真的跑起来”的工具；npm 则是随 Node.js 安装的包管理工具，常用于给项目取用代码包。课程项目文件像作业文件夹，终端是你向电脑输入操作命令的窗口。npm 的用途与 Node.js 自身的分工，可参考 npm 官方说明；Node.js 安装时会一并安装 npm，但二者的版本发布节奏不同。
截至 2026 年 9 月 26 日，Node.js 官方版本表将 v24 标为 LTS、v26 标为 Current；LTS 是长期支持版本，适合作为没有额外课程要求时的入门选择。若老师要求 v22 或其他版本，先按课程规定做，不要因为 v24 更新就替换已有项目环境。(Node.js 官方发布状态表)
先用下面的对照表决定安装路线。注意，表格中的版本状态会变化；下载前应再看一次官方页面，而不要依赖旧教程里的固定版本号。
| 你的情况 | 建议做法 | 主要优点 | 需要留意 |
|---|---|---|---|
| 个人 Mac，课程未指定版本 | 从 Node.js 官方下载页选择 Node.js 24 LTS，并按页面提供的 macOS 选项安装 | 入门步骤直接，npm 随安装提供 | 安装后重新打开终端并核对版本 |
| 课程明确要求其他大版本 | 先按课程说明核对要求；在隔离环境中确认前，不替换现有版本 | 降低作业和课程示例不兼容的风险 | 不能只看“能运行”，还要看版本是否符合要求 |
| 学校管理的 Mac | 先确认是否允许安装；如果被策略限制，使用获准的学校环境或其他课程许可方式 | 不触碰受保护的系统设置 | 不要尝试绕过权限或修改受管理配置 |
Node.js 24 一定适合我的课程吗？
不一定。它适合课程没有指定版本、且你需要从头搭环境的情况；如果项目说明文件或教师明确指定了版本，优先服从课程要求。可查看 Node.js 官方发布状态表确认版本轨道，再从官方 Node.js 下载页选择对应版本。
SECTION 02个人 Mac 的官方安装路线
官方页面会随版本更新而变化，因此按页面当下给出的系统与芯片选项操作，不要从不明来源下载安装包。Node.js 官方下载页提供版本与安装资料；下载时应以官方页面实际提供、与你的 Mac 相匹配的安装选项为准。(Node.js 官方下载页)
按下面步骤完成首次安装：
- 先查课程要求。查看课程讲义、项目说明，以及项目根目录是否有
package.json、版本配置文件或明确的 Node.js 版本说明。发现指定版本时，先记录下来，不要直接安装另一个版本覆盖课程环境。 - 确认这台 Mac 是否允许安装。个人电脑通常可按官方页面安装；学校电脑如果提示需要管理员授权，或系统明确禁止安装，到此停止并询问学校 IT 或课程教师，不要自行绕开管理策略。
- 从官方页面选 Node.js 24 LTS。核对下载页标注的版本轨道和 macOS 安装选项，再按安装器提示完成安装。具体安装文件以官方页面当前显示为准。
- 关闭并重新打开终端。终端是命令输入窗口；重新打开可以避免它仍使用安装前的环境信息。
- 分别检查 Node.js、npm 和命令路径。在终端逐行运行：
bash
node -v
npm -v
command -v node
command -v npm
node -v 和 npm -v 应分别显示版本号；command -v 应显示对应命令的位置。Node.js 与 npm 版本号不同是正常的，不要因为两者数字不一致就认定安装失败。(npm 官方版本说明)
6. 运行最小程序。先在终端输入 mkdir -p ~/Documents/node-first，再输入 cd ~/Documents/node-first。新建 hello.js 文件，写入 console.log("Hello, JavaScript!"); 并保存，然后运行 node hello.js。终端出现 Hello, JavaScript!，说明当前终端确实找到了 Node.js，并执行了这个文件。Node.js 官方文档也用“创建文件，再用 node 文件名 执行”的方式演示运行流程。(Node.js 官方运行示例)
⚠️ 如果安装器提示需要管理员授权，而你使用的是学校管理的 Mac，不要自行更改权限或尝试绕过限制。先问清课程是否提供可用的学校环境；未经许可的安装可能违反设备管理规则，也会让后续排错更复杂。
这条路线的优点是步骤少、验证清楚；缺点是课程若要求多个 Node.js 版本，单次安装未必能满足所有项目。对于第一次入门，先把课程要求、命令返回结果和实际运行结果对齐，比急着安装版本管理工具更稳妥。
SECTION 03学校电脑与已有项目的分流检查
学校电脑不能安装软件，先区分“没有权限”和“命令暂时不可用”：前者要按校方规则申请或换获准环境；后者可以先做低风险检查。不要把项目从电脑 A 的文件夹打开，却在电脑 B 的终端里运行——代码文件、终端和运行环境必须对应同一台机器。
学校电脑不让安装，还能继续做课程项目吗？
可以先问教师或学校 IT 是否提供统一的编程环境，再按课程规则选择浏览器练习或获准使用的远程 Mac。若改在远程 Mac 上继续，先确认项目文件已经放到那台机器可访问的位置，并在那台机器的终端里运行命令；本地终端无法直接运行只存在远程桌面中的文件。
安装后，终端为什么提示找不到 node？
先按顺序判断，不要马上编辑 shell 配置文件：
- 若
node -v和npm -v都提示命令不存在，先关闭终端再打开，并重新检查。 - 若仍找不到，运行
command -v node与command -v npm；没有返回路径，就回到官方安装页面核对是否装对版本和 macOS 选项。 - 若
node -v有版本号而npm -v不可用，或两条命令指向意外位置，先保存终端完整提示，暂停卸载、改路径或全局重装，向课程教师或学校 IT 求助。
路径可以理解为系统查找程序的地址清单。你现在只需检查命令是否可找到；在不清楚安装方式和设备权限前，不要照搬网上的路径修改命令。需要核对 v24 时，回到前文的 Node.js 官方发布状态表与下载页查看当前信息。
SECTION 04VS Code 首个练习验收
VS Code 是编辑和查看代码的工具，Node.js 才负责运行 JavaScript；装好编辑器不代表运行环境已经可用。VS Code 官方将 Node.js 列为需要单独准备的开发组件之一，且 macOS 安装步骤是打开 .dmg，再将应用拖到“应用程序”文件夹。(VS Code 官方组件说明)
Node.js 24 安装后，怎么用 VS Code 跑第一个程序？
先打开 VS Code，再打开刚才创建的 node-first 文件夹，并确认 hello.js 显示在这个目录下。若你使用 VS Code 集成终端，在其中运行 pwd 查看当前目录；再执行 node -v，确认终端找得到运行环境，然后运行 node hello.js。VS Code 的集成终端和普通终端都能输入命令，但它们必须定位到保存 hello.js 的同一个项目目录。
| 验收项 | 通过标志 | 未通过时先检查 |
|---|---|---|
| Node.js 可用 | node -v 返回版本号 |
终端是否重新打开，是否安装了课程要求的版本 |
| npm 可用 | npm -v 返回版本号 |
command -v npm 是否有路径；不要先全局重装 |
| 项目目录正确 | 终端当前目录就是 node-first 文件夹 |
VS Code 打开的文件夹与终端位置是否一致 |
| 程序可运行 | node hello.js 后显示 Hello, JavaScript! |
文件是否保存、文件名是否拼对 |
若你想在 macOS 终端输入 code . 打开当前文件夹，VS Code 官方要求先从命令面板运行“将 code 命令安装到 PATH”，随后重新启动终端；这一步仅影响 code 命令，不是安装 Node.js 的必要条件。(VS Code 官方 macOS 安装说明)
SECTION 05按课程环境决定是否切换设备
如果本地 Mac 能安装课程指定版本，且项目也能运行，继续使用本地环境通常最省事。学校电脑受管理、无法安装，或你需要在另一台 Mac 上继续课程时，获准的远程 Mac 可以作为替代；但远程连接会增加文件传输、连接方式和运行位置的核对成本，切换前应确认项目文件已在远端，并在远端终端重新做版本检查。
对照课程要求再做选择：
- ✅ 本地 Mac 已获准安装，作业也在本机：继续本地运行，减少设备切换。
- ✅ 学校电脑限制安装，课程允许其他环境：先咨询教师，再考虑浏览器练习或远程 Mac。
- ⚠️ 项目要求特定版本，当前环境不一致：不要直接升级或替换；先用独立环境验证，并向课程确认。
- ❌ 课程禁止远程环境，或必须使用本机的特定接口：不要租用远程方案来替代课程指定条件。
如果你需要先了解可用的远程 Mac 学习方案，可以查看 MACNOX 的相关服务入口。需要比较租用成本时，再查看 MACNOX 的方案与价格页面。
本地方案没有远程连接和文件同步步骤，但学校策略可能不允许安装；浏览器练习启动快，却不一定能复现课程要求的完整本地项目环境；远程 Mac 可让你在获准的 macOS 环境里继续操作，但连接、文件位置和终端都要核对。若你只是短期补齐课程练习所需的 Mac 环境，可先比较自有设备、学校提供的资源与 MACNOX 远程 Mac；若需要长期稳定使用、必须依赖本机接口，或课程不允许远程访问，则先选本地设备或学校批准的方案，不必租用。