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,可以避免长期依赖机器上过时的全局脚手架。

一次完成环境自检

在新打开的终端中依次执行下面四条命令。它们不会修改系统,只读取已安装工具的版本,因此适合作为安装完成后的第一轮检查。

bash
node --version
npm --version
npx --version
git --version

预期输出

text
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 项目,后续遇到依赖或启动问题时,才能把“基础运行时未准备好”从排查范围中排除。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

准备 Node.js 环境

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通