react开发环境搭建

肥晨

发布于 2024-09-19 19:27:31

6500

代码可运行

文章被收录于专栏：农民工前端

运行总次数：0

代码可运行

准备工作

Node.js 安装方法：

方式一：使用 NVM 安装 Node.js

NVM 下载地址：nvm-windows
Node.js 包下载地址：Node.js Releases
优点：NVM 允许灵活切换 Node.js 版本，适合需要管理多个版本的情况。

方式二：直接安装 Node.js

Node.js 下载地址：Node.js 官方下载
优点：直接安装更简单，适合不需要频繁切换版本的用户。

创建 React 项目

要创建一个新的 React 项目，可以使用以下几种方法。以下是使用 create-react-app 工具的标准步骤，这是最常用的方法：

使用 create-react-app 创建 React 项目

确保你已安装 Node.js 和 npm 你可以通过以下命令检查是否安装了 Node.js 和 npm：

node -v
npm -v

如果没有安装，请先安装 Node.js（包含 npm）。

安装 create-react-app 你可以全局安装 create-react-app 工具（可选）：

npm install -g create-react-app

创建一个新的 React 项目 使用 create-react-app 创建一个新的项目，替换 my-app 为你想要的项目名称：

npx create-react-app my-app

npx 是 npm 5.2.0 及更高版本随附的工具，用于运行命令行工具而无需全局安装。

进入项目目录 进入你创建的项目文件夹：

cd my-app

启动开发服务器 启动项目的开发服务器：

npm start

默认情况下，开发服务器会在 http://localhost:3000 运行。

打开浏览器查看项目 你可以在浏览器中访问 http://localhost:3000，你会看到 create-react-app 默认生成的欢迎页面。

使用 Vite 创建 React 项目

作为另一种现代的选择，你还可以使用 Vite 创建 React 项目，它通常具有更快的启动时间和构建速度：

安装 Vite 使用以下命令创建新项目，替换 my-app 为你的项目名称：

npm create vite@latest my-app --template react

进入项目目录

cd my-app

安装依赖

npm install

启动开发服务器

npm run dev

默认情况下，开发服务器会在 http://localhost:5173 运行。

选择 create-react-app 或 Vite 取决于你的项目需求和个人偏好。两者都是创建 React 项目的有效工具。

启动项目效果

安装出现的情况

Need to install the following packages:
  create-react-app@5.0.1
Ok to proceed? (y)

输入y即可

react项目文件讲解

在一个使用 create-react-app 工具创建的 React 项目中，默认的项目结构包含了一些标准的文件和目录。以下是对这些文件和目录的详细讲解：

1. 项目根目录

node_modules/ 存放项目依赖的第三方库和模块。这个目录是由 npm 自动生成的，不需要手动管理。
public/ 存放公开静态资源的目录。该目录下的文件会被直接暴露在生产环境中，不会经过 Webpack 处理。
- index.html 这是单页面应用的根 HTML 文件。React 应用会被挂载到这个文件中的 div 元素（通常是 id="root"）。
src/ 存放项目源代码的目录。这是你主要的开发目录。
- index.js 应用的入口文件，React 应用会在这里被渲染到 index.html 文件中的 root 元素中。
- App.js 这是一个示例组件，作为应用的主要组件。通常，这个文件会包含应用的主要结构和逻辑。
- App.css 与 App.js 相关的 CSS 文件，用于样式化 App 组件。
- index.css 全局样式文件，应用于整个应用的样式。
- logo.svg 默认的 React 图标 SVG 文件，通常用于示例和测试。
- serviceWorker.js 一个用于注册服务工作线程的文件（在创建 PWA 时可以使用）。在最新版本的 create-react-app 中，这个文件可能被移除或不推荐使用。
这些文件都可以移除或不推荐使用
.gitignore 用于指定在使用 Git 版本控制时，哪些文件和目录应该被忽略。例如，node_modules/ 和 build/ 文件夹。
package.json 项目的配置文件，包含项目的依赖、脚本、项目元数据等。你可以在这里定义项目的各种设置和依赖。
package-lock.json 锁定依赖版本的文件。它确保在不同的机器上安装的依赖版本一致。
README.md 项目的说明文件。你可以在这里添加项目的概述、使用说明、安装步骤等。
yarn.lock 如果你使用 Yarn 作为包管理器，这个文件会被创建，功能类似于 package-lock.json，用于锁定依赖版本。

2. 其他可能的目录和文件

src/components/ 通常你会创建这个目录来存放你的 React 组件文件。每个组件通常会有一个 JavaScript/TypeScript 文件和一个对应的 CSS 文件。
src/assets/ 用于存放静态资源，如图片、字体等。
src/utils/ 用于存放工具函数或帮助类文件。
src/hooks/ 用于存放自定义的 React Hooks。

3. 配置文件

jsconfig.json 或 tsconfig.json 如果你使用 TypeScript 或想要更好的 JavaScript 代码提示，可能会看到这些配置文件。
eslint.json 如果项目使用了 ESLint 进行代码检查，可能会有这个配置文件，用于定义代码检查规则。
prettier.config.js 如果使用 Prettier 进行代码格式化，可能会有这个配置文件。