003 在 Linux 上搭建 React 开发环境

在 Linux 系统上安装 React JS 可以帮助你搭建一个用于开发动态交互式 Web 应用的环境,这是一个广泛使用的 JavaScript 库。

  • 需要 Node.js 和 npm 来管理依赖并运行 React 应用
  • 支持高效开发现代用户界面
  • 提供稳定流畅的开发与测试环境

无论你使用 Ubuntu、Fedora 还是其他 Linux 发行版,以下步骤都可以帮助你快速开始 React 开发。


前置条件

在 Linux 上搭建 React 醒目,需要满足以下要求:

系统要求

  • Linux 操作系统(如 Ubuntu、Fedora 或 Debian)
  • Node.js(用于在浏览器外运行 JavaScript)
  • npm(用于管理包和依赖)
  • 终端(Terminal)或命令行工具

必要工具与软件

  • 已安装并配置 Node.js 和 npm
  • Git(可选,用于版本控制和克隆仓库)

在 Linux 上搭建 React 项目(步骤指南)

首先需要在电脑上安装 Node.js。安装 Node.js 时通常会连同npm(Node Package Manager)一起安装 ,因为它是 Node.js 的一部分。

如果 npm 没有自动安装,可以从 npm 官网单独下载并安装。

第 1 步:安装 Node.js

搭建 React 项目的第一步是已安装 Node.js。React 需要 使用 Node.js 在服务器端运行 JavaScript 并处理包管理。

1. 更新系统软件包列表

打开终端,然后更新系统的软件包列表。

sudo apt update
2. 安装 Node.js

在更新软件包列表之后,在终端中输入以下命令进行安装。

sudo apt install nodejs
3. 安装验证

运行以下命令,你应该能够在系统中看到已安装的 Node.js 版本信息。

node -v
安装验证

单独安装 npm(Node 包管理器)

npm 是用于安装 React JS 及其他依赖项的 Node.js 默认的包管理工具。

1. 安装 npm

如果 Node.js 安装时未自动包含 npm,则需要运行以下命令装:

sudo apt install npm
2. 安装验证

运行以下命令,你应该能够看到系统中已安装的 npm 版本信息。

npm -v
安装验证

创建 React 应用

在安装 Node.js 和 npm 之后,你就可以创建你的第一个 React 项目了。推荐使用 Vite,它提供更快的构建速度和更优化的项目结构。当然,如果有兼容旧项目的需求,也可以使用 Create React App(CRA)

Vite 是一个现代构建工具,具有极快的启动速度、极少的配置需求,以及更好的开发体验。

1. 创建项目

运行以下命令,使用 Vite 创建一个新的 React + JavaScript 项目:

npm create vite@latest my-app -- --template react
2. 进入项目目录并安装依赖

使用以下命令进入项目文件夹,安装项目所需的依赖项:

cd my-app
npm install
3. 启动开发服务器

运行以下命令启动开发服务器,在浏览器中预览初始应用项目:

npm run dev

在浏览器中访问 http://localhost:5173,即可查看我们创建的 React 初始项目应用。

使用 Create React App(已弃用)

Create React App 曾经是创建 React 应用的标准工具,但自 2023 年起已被弃用,不再推荐用于创建新项目。

1. 创建项目:

运行以下命令,使用 CRA 生成一个创建新的 React 项目:

npx create-react-app my-app
2. 进入项目目录

使用下面的命令进入创建的项目文件夹:

cd my-app
3. 启动服务器

运行下面的命令启动开发服务器来运行我们的初始 React 项目应用:

npm start

在浏览器中访问 http://localhost:3000 运行应用。

启动服务器

项目名称需要使用小写字母,以避免 npm 命名报错。

验证安装

当开发服务器运行后,在浏览器中打开 http://localhost:3000。如果一切配置正确,你应该会看到默认的 React 欢迎页面,并显示“Learn React”信息。这表示你已在 Linux 系统中成功安装 React 。

Linux 上安装 React JS 的替代方法

虽然 Create React App 是最常用的 React 项目初始化方式,但也有其他可用的替代方案来创建 React 应用。

使用 npx

npx 是 npm 自带的包运行工具,可以让你无需全局安装即可直接执行命令。

  • 这个命令会在 my-app 文件夹 中创建一个新的 React 应用,而不需要全局安装 create-react-app。
npx create-react-app my-app

服务器也是通过命令 npm start 启动。

使用 Yarn

Yarn 是 npm 的替代包管理工具,在某些情况下速度更快、稳定性更高。如果你更喜欢使用 Yarn,可以按照以下步骤安装 React。

1. 安装 Yarn

要安装 Yarn,需要在终端中运行以下命令:

npm install --global yarn
2. 创建新的 React 应用

使运行以下命令使用 Yarn 创建一个新的 React 应用。

yarn create react-app my-app
3. 进入项目目录并启动开发服务器

进入项目文件夹启动服务器。

cd my-app
yarn start

常见问题与错误排查

在安装或开发过程中可能会遇到一些常见问题,但大多数都可以通过正确的理解和修复来解决。

1. 未找到 Node.js 或 npm

如果出现 “node: command not found”“npm: command not found” 错误,通常是 Node.js 和 npm 未正确安装。

解决方法如下:

  • 请确保严格按照 Node.js 和 npm 的安装步骤进行操作
  • 按照前面的说明重新安装 Node.js 和 npm
2. 缺少依赖或构建错误

有时在安装 React 或启动开发服务器时,可能会遇到与依赖缺失或构建相关的错误。

解决方法如下:

运行以下命令来安装所需的依赖项。

npm install

如果你使用的是 yarn,请运行以下命令:

yarn install
3. 本地服务器无法运行

如果无法在 http://localhost:3000 中启动 React 开发服务器,你可能需要检查端口或防火墙设置。

解决方法如下:

检查是否有其他进程正在占用 3000 端口,可以运行以下命令:

lsof -i :3000

如果有其他进程正在占用该端口,请停止该进程,然后重新启动你的 React 应用。