React / 系统课时
准备 Node.js 环境
准备 Node.js 环境
Next.js 的开发、依赖安装和本地启动都依赖 Node.js。本课不绑定某一种安装器,而是建立一套可验证的环境基线:安装合适的 Node.js,确认 npm、npx 与 Git 可用,并知道版本过旧或命令找不到时应该从哪里排查。
学习目标
- 准备满足当前 Next.js 开发要求的 Node.js 环境
- 理解
node、npm、npx和 Git 在开发流程中的作用 - 用一组命令完成版本检查,并处理最常见的 PATH 与版本问题
先准备合适的 Node.js
新环境优先安装 Node.js 的当前 LTS 版本;如果项目明确锁定版本,则以项目要求为准。当前 Next.js 开发至少应准备 Node.js 20.9 或更高版本。Windows 和 macOS 可以使用 Node.js 官方安装器,也可以使用版本管理器;Linux 应确保软件源或版本管理器安装出的版本达到项目要求。
安装完成后要关闭并重新打开终端,因为安装程序通常会修改 PATH。不要只凭“安装成功”的界面判断环境是否可用,后面的命令检查才是最终依据。
认识常用命令行工具
| 工具 | 作用 | 本课检查点 |
|---|---|---|
node |
执行 JavaScript 与 Next.js 服务端代码 | 能输出满足要求的版本 |
npm |
安装依赖并执行 package.json 脚本 |
能正常输出版本 |
npx |
临时执行 npm 包中的命令 | 能正常输出版本 |
| Git | 管理源码版本,便于后续提交与协作 | git 命令可用 |
npm 和 npx 通常随 Node.js 一起提供,不需要单独安装。初始化 Next.js 项目时优先使用 npx create-next-app@latest,可以避免长期依赖机器上过时的全局脚手架。
一次完成环境自检
在新打开的终端中依次执行下面四条命令。它们不会修改系统,只读取已安装工具的版本,因此适合作为安装完成后的第一轮检查。
node --version
npm --version
npx --version
git --version预期输出
v<NODE_VERSION>
<NPM_VERSION>
<NPX_VERSION>
git version <GIT_VERSION>实际版本号会因安装时间不同而变化。关键是四条命令都能被识别,并且 node --version 显示的版本不低于项目要求;若本课程使用当前 Next.js,则 Node.js 至少应达到 20.9。
按现象处理常见失败
如果 node 提示命令不存在,先确认 Node.js 已完成安装,再重新打开终端;仍失败时检查 PATH 是否包含 Node.js 的安装目录。不要急着重复安装多个版本,否则更容易出现“终端实际调用了旧版本”的问题。
如果 node 可用但版本过低,升级 Node.js 后再次打开终端并复查版本。使用版本管理器时,要确认当前 shell 已切换到目标版本,而不是只完成了下载。
如果 npm 或 npx 找不到,而 node 可以运行,通常说明安装不完整或 PATH 异常。优先修复 Node.js 安装本身,不要从不可信来源单独下载同名可执行文件。
如果只有 Git 不可用,Node.js 与 Next.js 仍可能运行,但你会失去正常的版本控制工作流。安装 Git 后重新打开终端,再执行同一组检查即可。
环境准备的验收标准
环境准备完成时,你应该能在任意新终端中稳定调用 node、npm 和 npx,Node.js 版本满足项目基线,Git 也能正常响应。此时再开始创建 Next.js 项目,后续遇到依赖或启动问题时,才能把“基础运行时未准备好”从排查范围中排除。