react开发环境搭建

news2024/11/16 11:40:21

在这里插入图片描述

文章目录

- 准备工作
- 创建 React 项目
- - - 使用 create-react-app 创建 React 项目
    - 使用 Vite 创建 React 项目
    - 启动项目效果
    - 安装出现的情况
- react项目文件讲解
- - - 1. 项目根目录
    - 2. 其他可能的目录和文件
    - 3. 配置文件

准备工作

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 进行代码格式化，可能会有这个配置文件。