准备工作
安装 React 模板前，先确认本机已安装 Node.js 和 npm。Node.js 建议使用当前 LTS 版本，避免因版本过低导致依赖安装失败。在终端执行 node -v 和 npm -v，能输出版本号即可继续。
方式一：使用 Vite 安装 React 模板
Vite 是目前常用的 React 项目脚手架，安装速度快，配置简单。
执行创建命令
在终端运行：
npm create vite@latest my-react-app — –template react
其中 my-react-app 是项目目录名，react 表示使用 JavaScript 模板。如果需要 TypeScript，将 react 改为 react-ts。
安装依赖并启动
进入项目目录并安装依赖：
cd my-react-app
npm install
npm run dev
浏览器访问终端提示的本地地址，看到 React 默认页面即安装成功。
方式二：使用 Create React App
如果团队仍在使用 CRA，可以执行：
npx create-react-app my-app
cd my-app
npm start
CRA 会一次性生成完整项目结构，适合传统教学或旧项目维护。需要注意的是，CRA 创建速度相对较慢，新项目更推荐 Vite。
方式三：使用 Next.js 模板
需要服务端渲染或文件路由时，可以使用 Next.js：
npx create-next-app@latest my-next-app
按提示选择 TypeScript、ESLint、Tailwind CSS 等选项后，进入目录执行 npm run dev 即可启动。
模板安装后的目录说明
以 Vite 为例，主要文件包括：
index.html：页面入口src/main.jsx：React 挂载入口src/App.jsx：根组件package.json：依赖与脚本配置
理解这些文件的位置，后续修改模板会更顺畅。
常见问题排查
如果安装过程中断，先删除 node_modules 和 package-lock.json，再重新执行 npm install。遇到端口占用，可在启动命令后加 --port 3001 更换端口。若模板下载缓慢，可切换 npm 镜像源后重试。
总结
React 模板安装并不复杂，关键是选对脚手架并保证 Node.js 环境正常。新项目优先使用 Vite，需要 SSR 时选择 Next.js，维护旧项目再用 Create React App。按步骤执行命令，基本都能一次跑通。
