React / 系统课时
安装 Node.js 与开发工具
安装 Node.js 与开发工具
本课完成 React 开发所需的基础环境安装。你将安装 Node.js、npm、Git 和代码编辑器,并通过版本检查、初始化仓库和打开项目目录验证所有工具都能正常协作。
学习目标
- 安装 Node.js LTS,并确认
node与npm命令可用 - 安装 Git 和代码编辑器,确认命令行入口正常
- 创建本地项目目录并完成一次环境验收
安装前检查
准备一个具有软件安装权限的系统账户,并关闭仍在使用旧 Node.js 的终端窗口。课程建议使用 Node.js 的长期支持版,而不是追求最新实验版本,这样依赖兼容性通常更稳定。
安装路径尽量使用默认位置,目录名避免中文、空格和特殊符号。Windows 用户需要留意安装器中的 PATH 选项,macOS 与 Linux 用户则应确认终端使用的是当前账户的环境变量。
安装 Node.js 与 npm
从 Node.js 官方下载页选择 LTS 安装包,按默认组件完成安装。npm 会随 Node.js 一起安装,不需要单独下载。安装结束后重新打开终端,让新的 PATH 配置生效。
在 PowerShell、Terminal 或 Bash 中执行版本检查:
node --version
npm --version预期输出如下,实际版本号会因安装时间不同而变化:
v<MAJOR>.<MINOR>.<PATCH>
<MAJOR>.<MINOR>.<PATCH>如果两个命令都能返回版本号,说明 Node.js 运行时和 npm 包管理器已经进入 PATH。
安装 Git 与代码编辑器
安装 Git 时保留命令行组件和默认 PATH 设置。代码编辑器建议使用 Visual Studio Code,并启用命令行入口;本课程后续会使用集成终端、扩展和项目搜索功能。安装完成后执行:
git --version
code --version预期输出类似:
git version <MAJOR>.<MINOR>.<PATCH>
<MAJOR>.<MINOR>.<PATCH>
<COMMIT_ID>
<ARCH>code --version 通常会输出编辑器版本、提交标识和系统架构。不同平台的行数可能略有差异,只要命令能够识别即可。
创建并验证工作目录
选择一个固定的开发目录,然后创建本课程项目文件夹。下面的命令可以在 Bash、macOS Terminal、Linux Shell 或支持这些命令的终端中执行:
mkdir react18-fullstack
cd react18-fullstack
git init
code .预期输出包含 Git 仓库初始化信息:
Initialized empty Git repository in <PATH>/.git/同时,Visual Studio Code 应打开 react18-fullstack 目录。实际路径会随你的保存位置不同而变化。
常见失败与修复
遇到 node、npm 或 git 无法识别时,先关闭并重新打开终端,再用 where node(Windows)或 which node(macOS/Linux)确认命令位置。仍无结果时,重新运行安装器并检查 PATH 选项。
遇到 code 无法识别时,Windows 可重新安装并勾选加入 PATH;macOS 可在编辑器命令面板中安装 code Shell 命令;Linux 应确认安装包已创建命令行链接。
不要通过长期使用管理员权限来绕过 npm 权限错误。权限异常通常说明安装目录或全局包目录配置不合理,应先修正环境,而不是把所有命令都改成管理员执行。