
React 项目创建和运行页面并不复杂,通常使用官方推荐的 Create React App
工具可以快速上手。我会为你介绍主要步骤,并用一个表格汇总常用的 npm 脚本命令。
命令 | 功能描述 | 备注 |
---|---|---|
npm start |
启动开发服务器 ,通常在 http://localhost:3000 |
修改代码会自动刷新页面(热重载) |
npm run build |
生成用于生产环境 的优化构建文件(在 build 目录) |
需部署到服务器才能正常访问 |
npm test |
启动测试运行器 | |
npm run eject |
暴露 所有配置文件(不可逆) | 除非你非常熟悉构建工具且确实需要深度定制,否则慎用 |
🛠️ 创建 React 项目
创建 React 项目最推荐的方式是使用 Create React App
(CRA),它帮你处理了所有繁琐的 Webpack、Babel 等开发环境的配置。
-
确保有 Node.js 环境 :你需要先安装 Node.js(会自带 npm),建议选择 LTS 版本。安装后可以在终端(命令行)输入
node -v
和npm -v
来检查是否安装成功及查看版本。 -
执行创建命令:打开终端,进入你希望创建项目的目录,然后运行:
bash
npx create-react-app my-react-app
-
npx
会临时安装create-react-app
并用它来创建项目,完成后会自动清理,无需全局安装。 -
my-react-app
是你的项目名称,可以自定义。 -
这个过程会自动安装所有必需的依赖,可能需要一些时间。
-
-
了解项目结构:项目创建成功后,主要会包含以下目录和文件:
-
node_modules/
: 项目依赖包存放目录。 -
public/
: 存放静态资源,如index.html
(页面模板)、favicon.ico(网站图标)等。 -
src/
: 主要工作目录,你的组件和样式文件大多放在这里。-
App.js
: 根组件,也是主要的页面组件。 -
index.js
: 项目入口文件 ,它会将App
组件渲染到public/index.html
中一个 id 为 "root" 的 DOM 节点上。
-
-
package.json
: 记录项目信息、依赖和脚本命令。
-
▶️ 运行 React 页面
-
启动开发服务器 :在终端中,进入你的项目目录(例如
cd my-react-app
),然后运行:bash
npm start
命令执行后,CRA 会自动在浏览器中打开
http://localhost:3000
来预览你的应用。如果端口 3000 被占用,它会询问你是否使用另一个端口。 -
修改页面内容:
-
用代码编辑器打开
src/App.js
文件。 -
你会看到一个默认的函数组件,它返回一些类似 HTML 的 JSX 代码。修改这些 JSX 并保存文件。
-
浏览器中的页面会自动刷新以显示最新的更改。
-
📦 构建与部署
当你完成开发,需要将项目发布到线上时:
-
执行构建:在项目根目录运行:
bash
npm run build
这会在项目根目录生成一个
build
文件夹,里面包含了优化、压缩后的静态文件(HTML, CSS, JS, 图片等)。 -
部署 :将
build
文件夹里的全部内容上传到你的静态网站托管服务 或Web 服务器的指定目录即可。
💡 下一步探索
掌握了创建和运行,你可以继续探索:
-
组件化开发:将 UI 拆分成一个个可复用的组件。
-
JSX 语法:在 JavaScript 中编写类似 HTML 的结构。
-
状态管理 :使用
useState
Hook 管理组件内部数据。 -
路由 :使用
React Router
为应用添加多个页面。 -
样式:学习如何使用 CSS Modules、Styled-components 或 UI 库(如 Ant Design, Material-UI)来美化你的应用。
希望这些信息能帮助你顺利开始 React 开发之旅。