当前位置：首页 > news >正文

React开发环境配置详细讲解-04

news 2025/7/5 15:45:28

环境简介

前端随着规范化，可以说规范和环境插件配置满天飞，笔者最早接触的是jquery，那个开发非常简单，只要引入jquery就可以了，当时还写了一套UI框架，至今在做小型项目中还在使用，show一张效果图吧，当作留念了：
在这里插入图片描述
后来出现了Vue、Angular等，那语法格式实在费解，果断放弃了前端，后来又几经分分合合，至今算是集中在了React上了，但当初需环境时也是费了好大劲，为了刚接触的同学好理解，特意整理一下开发中关于React的环境配置，大体环境关系如下：
在这里插入图片描述

nvm：需要最先安装，用于对node.js解释器进行管理，相当于node.js的版本管理器，因为React开发需要node.js的支持；
node.js：安装好nvm后就需要安装node.js了，它可以理解为java的jdk；在React开发中可以理解为React的运行环境；
npm：React开发需要依赖各种不同的三方库，npm就是用于下载不同的三方库用，可以理解为java开发中的maven；

cnpm：功能同npm，因为npm的库包服务器在国外，下载速度有时会很慢，cnpm连接的是国内服务器；
yarn/tyarn：功能同npm，也是由于npm库在国外的原因，开发的另一个版本管理工具；

脚手架：这个不用解释了，网上N多，笔者主要用三个：学习使用（create-react-app），工作使用（ant-design，MUI），前者是官方给的，后者是三方开发的；
webpack：React应用打包工具；
babel：JSX语法转译工具，在React开发中会用到JSX语法（Facebook开发的一种被二次封装的js语法，主要是为了简化代码），这种语法不能被浏览器直接识别，因此在运行前需要一个类似编译的过程；
sass：css预处理器，这个是可选的，主要看css用哪种语言实现；

以上这些开发工具npm和nvm会使用的比较频繁，另外node.js和npm有一个版本对应关系。详细可查看https://nodejs.org/zh-cn/download/releases/网站查询。

环境安装

下列命令全是在笔者用的是MacOS系统下执行的，其它系统可查看官网安装方法：

安装nvm

nvm，全称Node Version Manager，是一个用于管理Node.js版本的工具。使用nvm，可以轻松地在同一台电脑上安装和切换不同版本的Node.js，从而方便地进行开发和测试。nvm提供了一些命令来管理Node.js版本，如安装、卸载、使用特定版本的Node.js等以满足不同项目的需求。

官网地址：https://nvm.uihtm.com/

curl -o- https://raw.githubusercontent.com/creationix/nvm/v0.39.0/install.sh | bash

常用命令：

nvm current //显示当前NVM使用的版本nvm ls //列出本地所有安装的node版本
nvm ls-remote //列出官网上node的所有版本
nvm version //显示当前系统默认使用的node版本
nvm use <version> // 切换使用指定的版本nodenvm install stable // 安装最新稳定版 node
nvm install <version> // 安装指定版本 
nvm uninstall <version> // 卸载指定版本node,（如果删除的为当前使用版本，要先执行解绑 nvm deactivate）nvm alias <name> <version> //给不同的版本号添加别名
nvm unalias <name> //删除已定义的别名
nvm alias default <version> //指定默认版本（设定后需要打开新的终端才生效）

安装npm

npm，全称Node Package Manager，是一个Node.js的包管理器。它允许开发者从npm注册表中安装和管理软件包，这些软件包可以是用于构建工具、库、框架等。npm最初是作为Node.js的一个子集而创建的，现在已经发展成一个独立的开源项目，被广泛应用于JavaScript项目依赖包的管理。

官网地址：https://www.npmjs.com/

nvm install stable # 会默认安装npm

常用命令（后面有全部命令介绍）：

npm -v #查看版本号
npm config list：# 查看配置信息，比如npm源等#常用包操作 
npm root #查看包的安装路径
npm list  #显示当前应用下的npm包npm i packageName -g #全局安装
#会下载到node_modules目录中，并修改package.json（dependencies中会增加）
npm i --save packageName
#会下载到node_modules目录中，并修改package.json（devDependencies中会增加）
npm install --save-dev packageNamenpm i packageName #安装在当前应用
npm i packageName@1.x  #安装指定版本
npm i packageName@2.5.8 --registry=https://registry.npm.taobao.org #指定临时下载源npm home packageName  # 打开默认浏览器跳转到github中express的主页
npm view packageName versions  # 查看所有express历史版本号（很实用）npm uninstall  包名  // 删除包# 本地安装根据package.json文件安装所有依赖包，将安装包放在 ./node_modules 下
npm install

环境设置

npm config set <key> <value> [-g|--global]
npm config get <key>
npm config delete <key>
npm config list
npm config editnpm config set proxy=http://xxx #因为公司的防火墙原因，无法完成任何模块的安装，这个时候设置代理可以解决
npm config set proxy null #解决Error: connect ECONNREFUSED 127.0.0.1:8087

镜像设置

一般不需要配置，直接使用cnpm和yarn即可

#检查当前镜像
npm config get registry
#官方默认全局镜像
npm config set registry https://registry.npmjs.org
#1,淘宝镜像源
npm config set registry https://registry.npmmirror.com
npm config set registry https://registry.npm.taobao.org
#2,腾讯云镜像源
npm config set registry http://mirrors.cloud.tencent.com/npm/
#3,华为云镜像源
npm config set registry https://mirrors.huaweicloud.com/repository/npm/# 删除镜像配置
npm config delete registry

缓存路径

一般不需要设置

#全局安装路径
npm config set prefix "D:\Program Files\nodejs\node_global"
#缓存路径
npm config set cache "D:\Program Files\nodejs\node_cache"# 查看项目中模块所在的路径
npm root
# 查看全局安装的模块所在路径
npm root -g

模块查询

express为一模块包名称

npm list  # 查看本地已安装模块的清单列表
npm ls express  # 查看本地已安装的express的详细信息
npm view express dependencies  # 查看某个包对于各种包的依赖关系
npm view express version  # 查看express最新的版本号
npm view express 或 npm info express # 查看最新的express版本的信息
npm view express repository.url  # 查看express包的来源地址npm repo express  # 打开默认浏览器跳转到github中express的页面
npm docs express  # 打开默认浏览器跳转到github中express的README.MD文件信息
npm home express  # 打开默认浏览器跳转到github中express的主页

模块安装

参数：[-S|--save|-D|--save-dev|-O|--save-optional] [-E|--save-exact] [--dry-run]

# 安装包加入到dependencies生产依赖，对应package.json文件的dependencies字段
npm i express -S  # 安装包加入到devDependencies开发依赖，对应package.json 文件的devDependencies字段
npm i express -D # 安装包加入到optionalDependencies可选依赖，对应package.json 文件的optionalDependencies字段
npm i express -O # 精确安装指定模块版本,package.json 文件的 dependencies 字段，以看出版本号中的^消失了
npm i express -E

模块卸载

npm uninstall express -g  # 卸载全局模块npm uninstall express  # 卸载模块，但不删除package.json中的对应信息
npm uninstall express --save-dev  # 卸载模块，同时删除package.json中dependencies下的信息

模块更新

npm outdated # 检查应用下是否有过时包
npm update express -g  # 全局更新
npm update express  # 更新最新版本的express
npm update express@2.1.0  # 更新到指定版本号的express
npm update express@latest  # 更新到最后的新版本

模块构建

npm init  # npm 初始化当前目录,在项目中引导创建一个package.json文件npm install   # 安装应用package.json文件中指定的所有依赖npm build    # 编译应用

模块运行

npm run customCommand #自定义的shell命令，比如npm run start

npm start [-- <args>]
npm stop [-- <args>]
npm restart [-- <args>]
npm test [-- <args>]

以上几个命令可在package.json中自定义，如下：

"scripts": {"start": "gulp -ws"
}

模块发布

这个命令需要当前package.json下执行

npm login
npm adduser yourUserName # 用户登陆
npm publish  # 执行package.json中相应的配置
npm  -f  unpublish  express@* # 撤消发布

模块清理

npm cache clean --force # 清除npm本地缓存node_modules目录下的内容 
npm prune  # 清除项目中没有被使用的包
npm dedupe # 删除重复的依赖项

安装cnpm和tyarn（可选）

这两个软件的功能和npm一样，使用方式也差不多，安装方式如下

npm install yarn tyarn -g
npm install cnpm -g

tyarn官司地址：https://yarnpkg.com/

cnpm官司地址：https://github.com/cnpm/cnpm

安装React

官司地址：https://react.dev/
如果用脚手架开发则不需要安装，另外这两个核心包不建议全局安装，因为每个应用的版本有可能都不一样。

npm install --save-dev react 
npm install --save-dev react-dom

如果采用传统开发，可从官网下载相应的js文件（只供学习用，生产开发时不要用这种模式）。

安装DevTools

安装cnpm install -g react-devtools，然后就可以在命令行输入react-devtools启动，使用前需要在.html文件，一般是主文件中加入：

<html><head><script src="http://localhost:8097"></script></head>
</html>

然后就可以在浏览器中看到：
在这里插入图片描述

安装Babel

官网地址：https://babeljs.io/repl/

npm install --save-dev babel-cli babel-core babel-polyfill babel-preset-es2015 babel-preset-react

这东西安装后，如果要单独使用，可以项目中创建一个名为的.babelrc文件，它用来设置不同环境的转码插件：

{plugins:["transform-export-extensions"],presets:["es2015", "react"]
}

单独使用时可用babel js/source -d js/build指令。

安装Sass（可选）

官方网址：https://www.sass.hk/

npm install -save-dev babel-loader sass-loader style-loader css-loader react-hot-loader

安装Webpack

官方网址：https://webpack.docschina.org/
模块打包器，作用就是把应用的所有依赖加载到单个文件中，以便在浏览器中运行。

npm install --save-dev webpack webpack-cli

安装后，需要在项目根目录下配置webpack.config.js配置文件。

安装Serve

这个是一个运行服务器，可以看成是个nginx

# 安装
npm install -g serve# 在项目下运行构建项目会生成一个打包后的待部署文件
npm run build# 运行build文件夹下的应用，serve -h
servr -s build # 默认羊肉串3000
serve -s build -l 4000 # 4000端口运行

安装ESLint

官方网址：https://eslint.org/
React代码格式检查工具。

npm -i -g eslint babel-eslint eslint-plugin-react eslint-plugin-babel

单独使用可运行eslint js/source/app.js指令，安装后需要在项目根目录下创建 .eslintrc文件：

package.json配置

{"eslintConfig": {"extends": "./node_modules/react-scripts/config/eslint.js"}
}

eslintrc文件配置

{"extends": "airbnb", //沿用名为airbnb的规则库"rules": {"semi": [2, "never"], //semi是个规则名，2表示抛出错误，1表示警告，0，关闭此规则，never表示不允许，相返的always表示允许，比如未使用变量的规则名称为'no-unused-vars'"react/prefer-stateless-function": 0,}
}

使用create-react-app脚手架创建React应用

官方文档：https://create-react-app.dev/
这个插件是官方用于创建工程使用的，使用方法如下：

安装

cnpm install -g create-react-app

初始化应用

# 会在当前目录中创建一个名为hello-world的文件夹并下载相当应该
cnpm init react-app hellp-world

在这里插入图片描述

运行

# 运行
npm run start