智享教程网
白蓝主题五 · 清爽阅读
首页  > 日常经验

手把手教你配置React开发环境

刚接触React的时候,最让人头疼的不是写组件,而是怎么把开发环境搭起来。很多人卡在第一步:Node.js装了吗?npm是什么?create-react-app又报错?别急,我来带你一步步走通这条路。

安装Node.js和npm

React依赖Node.js环境,所以第一步是去官网下载并安装Node.js。打开浏览器搜“Node.js官网”,选推荐版本(通常是LTS)下载,一路下一步就行。安装完成后,打开终端或命令行工具,输入:

node -v

如果返回类似 v18.x.x 的版本号,说明Node.js装好了。再输入:

npm -v

能看到npm的版本,那就没问题了。npm是Node.js的包管理工具,后面装React就靠它。

用create-react-app快速创建项目

Facebook官方提供了脚手架工具create-react-app,能帮你省去一堆配置。在命令行里运行下面这句:

npx create-react-app my-react-app

注意是npx,不是npm。npx会自动找最新版的create-react-app,不用你手动安装。等它跑完,进入项目目录:

cd my-react-app

然后启动开发服务器:

npm start

浏览器会自动打开 http://localhost:3000,看到那个旋转的React logo,就说明环境跑起来了。

项目结构简单说明

刚进项目可能会被一堆文件吓到。其实刚开始只需要关注几个:

  • src/App.js —— 主组件文件,页面内容在这里改
  • src/index.js —— 入口文件,渲染App组件到页面
  • public/index.html —— 唯一的HTML模板

比如想把“Hello World”打出来,打开App.js,把return里面的JSX改成:

<div>Hello World</div>

保存后,浏览器会自动刷新,变化立马就能看到。

常见问题处理

有时候执行npx create-react-app会卡住,大概率是网络问题。可以尝试切换npm源:

npm config set registry https://registry.npmmirror.com

这个是国内镜像源,速度更快。如果以后想换回来,把后面的网址换成 https://registry.npmjs.org 就行。

还有人遇到权限错误,尤其是在Mac上。这时候不要随便加sudo,容易出问题。建议重新配置npm全局路径:

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'

然后把 ~/.npm-global/bin 加到系统PATH里,具体操作看shell类型(bash还是zsh),改对应的配置文件就行。

小结一下流程

整个流程其实就四步:装Node.js → 用npx创建项目 → 进入目录启动 → 开始写代码。中间遇到报错别慌,大多数都是网络或权限的小问题,查一下错误信息基本都能解决。我第一次配环境折腾了大半天,现在十分钟搞定,熟练了就知道哪几个坑要绕开。