admin 管理员组

文章数量: 1184232

一、React开发环境简介

前端随着规范化，可以说规范和插件满天飞，笔者最早接触的是jquery，那个开发非常简单，只要引入jquery就可以了，当时还写了一套UI框架，至今在做小型项目时还会使用，show一张效果图吧，当作留念了：

后来出现了Vue、Angular等，相比传统的js语法格式变化比较大，所以笔者果断放弃了前端，后来又几经分分合合，至今算是集中在了React上了。

回想当初需环境时也是费了好大劲，为了刚接触的同学好理解，特意整理一下React开发环境配置，大体工具关系如下：

  1. nvm：需要最先安装，用于对node.js解释器进行管理，相当于node.js的版本管理器，因为React开发需要node.js的支持；
  2. node.js：安装好nvm后就需要安装node.js了，它可以理解为java的jdk；在React开发中可以理解为React的运行环境；
  3. npm：React开发需要依赖各种不同的三方库，npm就是用于下载不同的三方库用，可以理解为java开发中的maven；
  • cnpm：功能同npm，因为npm的库包服务器在国外，下载速度有时会很慢，cnpm连接的是国内服务器；
  • yarn/tyarn：功能同npm，也是由于npm库在国外的原因，开发的另一个版本管理工具；
  1. 脚手架：这个不用解释了，网上N多，笔者主要用三个：学习使用（create-react-app），工作使用（ant-design，MUI），前者是官方给的，后者是三方开发的；
  2. webpack：React应用打包工具；
  3. babel：JSX语法转译工具，在React开发中会用到JSX语法（Facebook开发的一种被二次封装的js语法，主要是为了简化代码），这种语法不能被浏览器直接识别，因此在运行前需要一个类似编译的过程；
  4. sass：css预处理器，这个是可选的，主要看css用哪种语言实现；

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

二、React开发环境配置

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

Node.js管理器nvm安装与常用命令

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

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

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

常用命令：

nvm current //显示当前NVM使用的版本
 
nvm ls //列出本地所有安装的node版本
nvm ls-remote //列出官网上node的所有版本
nvm version //显示当前系统默认使用的node版本
nvm use <version> // 切换使用指定的版本node
 
nvm install stable // 安装最新稳定版 node，会默认安装npm
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/

nvm install stable # 会默认安装npm

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

npm -v #查看版本号
npm config list：# 查看配置信息，比如npm源等

#常用包操作 
npm root #查看包的安装路径
npm list  #显示当前应用下的npm包
 
npm i packageName -g # -g全局安装，如果是项目独有则不需要加-g

#会下载到项目node_modules目录中，并修改package.json（dependencies中会增加）
npm i --save packageName
#会下载到node_modules目录中，并修改package.json（devDependencies中会增加）
npm install --save-dev packageName
 
npm i packageName #安装在当前应用
npm i packageName@1.x  #安装指定版本
npm i packageName@2.5.8 --registry=https://registry.npm.taobao #指定临时下载源

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 edit
 
npm 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
#1,淘宝镜像源
npm config set registry https://registry.npmmirror
npm config set registry https://registry.npm.taobao
#2,腾讯云镜像源
npm config set registry http://mirrors.cloud.tencent/npm/
#3,华为云镜像源
npm config set registry https://mirrors.huaweicloud/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 # 删除重复的依赖项

命令执行NPX指令

npm 5.2+ 引入的工具，用于直接运行命令行工具或临时安装包，无需全局安装。其功能基本可以覆盖NPM，但两者有一些区别：

  • npm主要用于Node.js 的包管理工具，用于安装、管理、发布和卸载依赖包，即管理依赖和包。通过 package.json 管理依赖关系，依赖安装到 node_modules 或全局目录；
  • npxn 是npm 5.2+ 引入的工具，用于直接运行命令行工具或临时安装包，无需全局安装，即运行命令工具或临时安装包，默认从 远程npm 注册表下载包到临时目录，而不依赖package.json 配置。它主要有以下功能：
    • 运行本地或远程的命令行工具（如 create-react-app）。
    • 临时安装包（避免全局污染）。
    • 调用项目本地安装的二进制文件（通过 ./node_modules/.bin/）。
npx create-react-app my-app  # 临时安装并运行
npx cowsay "Hello"          # 直接运行远程包

安装cnpm和tyarn（可选）

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

npm install yarn tyarn -g
npm install cnpm -g

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

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

三、React开发相关工具软件

安装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>

然后就可以在浏览器中看到：

不同的浏览器也会有这个插件，但国内的话Google安装比较麻烦，所以建议使用edge浏览器或使用chrome和devtools组合。

安装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/
模块打包器，作用就是把应用的所有依赖加载到单个文件中，以便在浏览器中运行。

npm install --save-dev webpack webpack-cli

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

安装Serve（推荐）

这个是一个运行服务器，可以看成是个nginx，正常来讲像webstorm自带了这个功能。

# 安装
npm install -g serve

# 在项目下运行构建项目会生成一个打包后的待部署文件
npm run build

# 运行build文件夹下的应用，serve -h
servr -s build # 默认端口3000
serve -s build -l 4000 # 指定4000端口运行

安装ESLint（推荐）

官方网址：https://eslint/
React代码格式检查工具，相当于sonaQ的功能一样，在代码编译前会先运行定义的规则，如不通过则不允许运行。

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/
这个插件是官方用于创建工程使用的，用于从零开始创建工程，使用方法如下：

脚手架安装

方式1-全局安装

  • 安装
cnpm install -g create-react-app
  • 初始化应用
# 会在当前目录中创建一个名为hello-world的文件夹并下载相当应该
cnpm init react-app hellp-world

  • 运行
# 运行
npm run start

方式2-局部安装（推荐）

更推荐的是通过以下npx指令安装，这样避免了全局版本冲突问题：

npx create-next-app@latest

推荐的三方脚手架

另外官网也介绍了几个生产级的React框架

  • nextjs：全栈的 React 框架 npx create-next-app@latest
  • React Router (v7)必备：是 React 最流行的路由库，可以与 Vite 结合创建一个全栈 React 框架npx create-react-router@latest
  • vitejs 必备：一个简单的原始React框架，它本质上是一个构建工具，提供了很多丰富的配置，可以加快开发效率，pnpm create vite my-vue-app
  • expo：是一个 React 框架，可以让你创建具有真正原生 UI 的应用，包括 Android、iOS，以及 Web 应用npx create-expo-app@latest

推荐的常用三方库

npm i nanoid # 生成 UUID
npm i prop-types # 限定标签类型和属性，用法同之前
npm i axios # ajax提交

npm i @tanstack/react-query # 远程数据获取

webpack打包

  • 创建一个名为webpack.config.js的配置文件：
const path = require('path');
 
module.exports = {
  entry: './src/index.js', // 项目的入口文件
  output: {
    filename: 'bundle.js', // 打包后的文件名
    path: path.resolve(__dirname, 'dist'), // 打包文件放置的目录
  }
};

在package.json中添加一个脚本来运行Webpack：

"scripts": {
  "build": "webpack"
}
  • 运行cnpm run build后，Webpack会在dist/目录生成bundle.js文件。

五、package.json文件

详细可参考：https://docs.npmjs/cli/v10/configuring-npm/package-json网站

package.json 文件是 Node.js 项目和许多前端 JavaScript 项目中的一个重要文件，它包含了项目的元数据和依赖信息。这个文件通常由几个部分组成，包括项目的名称、版本、描述、入口文件、依赖项、开发依赖项、脚本等。

{
  "name": "react",//发布到NPM平台上的唯一标识，如果没有正确设置这两个字段，包就不能发布和被下载
  "version": "1.0.0",//发布到NPM平台上的唯一标识，如果没有正确设置这两个字段，包就不能发布和被下载
  "description": "Command line instructions",//包的描述信息，将会在npm search的返回结果中显示，以帮助用户选择合适的包
  "private":ture,//设为true这个包将不会发布到NPM平台下
  "keywords": [//包的关键词信息，是一个字符串数组，同上也将显示在npm search的结果中
    "react",
    "es6",
    "react with es6"
  ],
  "homepage": "https://github/rainnaZR/es6-react",
  "bugs": {
    "url": "https://github/rainnaZR/es6-react",
    "email": "111@163"
  },
  "license": "ISC",
  "author": "ZRainna",
  "main": "src/pages/index.js", //包的入口文件
  "directories": {//CommonJS包所要求的目录结构信息，展示项目的目录结构信息(较少用)
    "tests": "tests",
    "lib":"lib",
    "docs":"docs"
  },
  "repository": {//包的仓库地址
    "type": "git",
    "url": "git+https://github/rainnaZR/es6-react.git"
  },
  //通过设置这个可以使NPM调用一些命令脚本，封装一些功能
  "scripts": {
    "start": "babel-node src/pages/index.js",
    "build": "webpack --config config/webpack.config.js",
    "watch": "webpack-dev-server --config config/webpack.config.js --hot --inline --progress"
  },
  "config": {//添加一些设置，可以供scripts读取用，同时这里的值也会被添加到系统的环境变量中,npm start的时候会读取到npm_package_config_port环境变量
      "port": "8080"
  },
  "babel": {  //JSX翻译器配置
    "presets": [
      "es2015",
      "react"
    ]
  },
  "devDependencies": { //开发环境，一般测试等一些包全在这里
    "webpack": "^1.13.2",
    "webpack-dev-server": "^1.16.1"
  },
  "dependencies": { //生产环境，会随应用一起打包
    "babel-loader": "^6.2.5",
    "babel-preset-es2015": "^6.14.0",
    "babel-preset-react": "^6.11.1",
    "react": "^15.3.2",
    "react-dom": "^15.3.2",
    "react-redux": "^4.4.5",
    "react-router": "^2.8.1",
    "redux": "^3.6.0"
  }
}

dependencies 版本依赖

库的版本一般由1.2.3三段组成，1称为主版本，2称为次版本。在 package.json 文件中，版本依赖前的符号（如 ^、~、>、>=、<、<=、* 等）用于指定依赖包的版本范围，以下是常见符号及其含义：

^：允许安装与指定版本兼容的最新版本，主版本不变

  • 示例：^1.2.3 表示允许安装的版本范围是 >=1.2.3 <2.0.0。
  • 适用场景：希望获得次版本号（minor）和修订号（patch）的更新，但主版本号不能变。

~：允许安装与指定版本兼容的最新版本，次版本不变

  • 示例：~1.2.3 表示允许安装的版本范围是 >=1.2.3 <1.3.0。
  • 适用场景：希望获得修订号（patch）的更新，但避免次版本号和主版本号的更改。

>、 <、>=、<=：分别指定版本范围的下限或上限

  • 示例：>1.2.3 表示安装大于 1.2.3 的版本；<2.0.0 表示安装小于 2.0.0 的版本。
  • 适用场景：需要精确控制版本范围。

*：匹配任意版本

  • 示例：* 表示安装任意版本。
  • 适用场景：需要快速指定版本范围，但不够精确（通常不推荐在生产环境中使用）。

无符号：安装指定版本

  • 示例：1.2.3 表示仅安装 1.2.3 版本。
  • 适用场景：需要固定依赖版本，避免任何更新。

组合使用

  • 含义：可以组合使用多个符号来指定复杂的版本范围。
  • 示例：>=1.2.3 <2.0.0 等价于 ^1.2.3；>=1.2.3 <=1.2.9 表示安装 1.2.3 到 1.2.9 之间的版本。

版本依赖注意事项

  • 版本控制：在团队协作和持续集成等场景中，package.json 文件的版本控制至关重要。强烈建议将 package-lock.json 一并提交到版本控制系统，以确保项目在所有开发环境中保持一致。
  • 依赖管理：定期更新 package.json 中的依赖项，确保使用的是最新的安全版本。可以使用 npm outdated 查看过时的依赖，使用 npm update 更新依赖。
  • 安全漏洞：使用 npm audit 检查项目中是否存在已知的安全漏洞，并使用 npm audit fix 自动修复安全问题。

本文标签： 开发工具 详解 环境 React

版权声明：本文标题：04. React开发工具与环境配置详解 内容由网友自发贡献，该文观点仅代表作者本人， 转载请联系作者并注明出处：http://www.roclinux.cn/b/1766428273a3457019.html， 本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌抄袭侵权/违法违规的内容，一经查实，本站将立刻删除。