如何让create-react-app锦上添花,满足实际需求?
create-react-app 是 React 官方为我们提供的一个单页应用脚手架,基于 webpack 配置了相关功能,babel、 图片处理、热加载、css 模块化、css 预处理器转换、代码分隔、生产构建、测试等。文档在这 create-react-app。强烈建议去看一看。
建议使用 npx create-react-app myapp
本地安装,而不是全局安装,以便更好的管理项目。
前端部分
在一定程度上来说,官方提供的脚手架已经接近完美了,接下来,扩展让它更完美。
脚手架默认把 webpack 等繁琐复杂的配置给隐藏起来了,目的是让开发者专注于项目。但也提供了一个命令npm run eject
来暴露相关配置,但这个行为是不可逆的。
我们要做的是锦上添花,在不暴露相关配置的情况下进行。
修改默认启动端口号:3000
在实际中,比如有多个应用,那么端口号冲突是很常见的,那么如何修改默认端口号呢?
- 安装
npm install --save-dev cross-env
,保证兼容性,因为 window 不支持直接PORT=5000 node scripts/start.js
- package.json 文件中启动命令前加入
cross-env PORT=设置的端口号
"scripts": { "start": "cross-env PORT=5000 node scripts/start.js" },
安装库
- axios
- react-router-dom
- redux、react-redux
- antd
- ...
修改打包后的资源路径为相对路径
在实际应用中,打包后的资源需要使用相对路径,只需在 package.json
中进行如下配置:
{ "scripts": { ... }, "homepage": "." }
扩展 webpack 配置
使用 react-app-rewired,安装这个工具后,在项目根目录中新建文件 config-overrides.js 文件。此时我们便可以在其中进行各种 webpack 的配置了~
但是!react-app-rewired2.x 以后,不再支持 injectBabelPlugin 的方式,需要安装 customize-cra。
具体的,ant design 官方文档已经给出了最新的解决方案。请前往详览。https://ant.design/docs/react/use-with-create-react-app-cn
这种方式就是我们推荐的方式。因为无需生成更多额外的文件,同时配置又趋于更简单可控的方式。
具体的操作步骤:
首先,安装 react-app-rewired:
npm install react-app-rewired --save-dev
然后修改package.json文件如下:
/* package.json */ "scripts": { - "start": "react-scripts start", + "start": "react-app-rewired start", - "build": "react-scripts build", + "build": "react-app-rewired build", - "test": "react-scripts test", + "test": "react-app-rewired test", }
接着,安装 customize-cra:
npm install customize-cra --save-dev
然后在根目录下添加 config-overrides.js文件,并进行配置,配置可参考customize-cra 文档:
- react 项目中我们最常用的组件库 antd,我们需要配置按需加载:
使用 babel-plugin-import,它是一个用于按需加载组件代码和样式的 babel 插件。
npm install babel-plugin-import --save-dev
配置 webpack:
/* config-overrides.js */ + const { override, fixBabelImports } = require('customize-cra'); + module.exports = override( + fixBabelImports('import', { + libraryName: 'antd', + libraryDirectory: 'es', + style: 'css', + }), + );
- antd 自定义主题
按照配置主题的要求,自定义主题需要用到 less 变量覆盖功能。
安装less和less-loader
npm install less less-loader --save-dev
配置 webpack:
/* config-overrides.js */ - const { override, fixBabelImports } = require('customize-cra'); + const { override, fixBabelImports, addLessLoader } = require('customize-cra'); module.exports = override( fixBabelImports('import', { libraryName: 'antd', libraryDirectory: 'es', - style: 'css', + style: true, }), + addLessLoader({ + javascriptEnabled: true, + modifyVars: { '@primary-color': '#1DA57A' }, + }), );
这里利用了less-loader的modifyVars来进行主题配置。当然这里的modifyVars的值也可以是一个theme文件。
- 打包后我们会发现静态文件夹中会有很多的 css 和 js 的 map 文件,那么该怎么关闭sourcemap呢?
/* config-overrides.js */ const { override, fixBabelImports, addLessLoader } = require("customize-cra"); + process.env.GENERATE_SOURCEMAP = "false"; module.exports = override( fixBabelImports("import", { libraryName: 'antd', libraryDirectory: "es", style: true, }), addLessLoader({ javascriptEnabled: true, modifyVars: { '@primary-color': '#1DA57A' }, }) );
- 其他配置
const { override, fixBabelImports, addLessLoader, addWebpackAlias, useBabelRc, addDecoratorsLegacy, addWebpackPlugin } = require('customize-cra'); const path = require('path') // 补充:对开发友好,打包完成桌面提醒 const WebpackBuildNotifierPlugin = require('webpack-build-notifier'); // 关闭 sourcemap process.env.GENERATE_SOURCEMAP = "false"; module.exports = override( // 按需加载 fixBabelImports('import', { libraryName: 'antd', libraryDirectory: 'es', // style: 'css' // 按需加载 style: true // antd 自定义主题 less }), // antd 自定义主题 less 变量覆盖全局 依赖 less、less-loader addLessLoader({ javascriptEnabled: true, modifyVars: { '@primary-color': '#814a96' } }), // 配置别名 addWebpackAlias({ '@': path.resolve(__dirname, 'src'), 'components': path.resolve(__dirname, 'src/components'), 'pages': path.resolve(__dirname, 'src/pages') }), // 允许使用.babelrc文件进行Babel配置。 useBabelRc(), // 装饰器 依赖 @babel/plugin-proposal-decorators addDecoratorsLegacy(), // 打包编译完成提醒 addWebpackPlugin(new WebpackBuildNotifierPlugin({ title: "My Project Webpack Build", logo: path.resolve("./img/favicon.png"), suppressSuccess: true })) )
npm install @babel/plugin-proposal-decorators --save-dev
npm install webpack-build-notifier --save-dev
proxy 代理
前端跨域处理。
在 src 目录下新建文件 setupProxy.js
安装 http-proxy-middleware:
npm install http-proxy-middleware --save-dev
配置 setupProxy.js
const proxy = require('http-proxy-middleware') module.exports = function(app) { app.use( proxy('/api', { target: 'http://xx.xx.xx.xx:8000/', changeOrigin: true, pathRewrite: { '^/api': '' } }) ) }
兼容 IE9
使用 create-react-app 官方提供的 react-app-polyfill,然后在入口文件 index.js 中引入
npm install react-app-polyfill --save
import 'react-app-polyfill/ie9'
后端部分
在实际工作中,需求确定后,前后端往往是同步开发的,对于接口的提供,后端没那么及时,但此时前端怎么在没有后端接口的情况下,还能正常开发呢,保证功能的正常。
答案是:mock 数据。
那么如何 mock 数据呢,方式很多,比如利用 easymock 在线模拟接口数据,当然最好的方式是自己搭建 node 服务,模拟接口及数据,更灵活,也能提升技术,了解后端的一些知识,更好的沟通与交流。
在 src 目录下新建文件夹 server-node,然后在下面再建一个 index.js 作为入口文件。
安装库
- koa
- koa-router
- koa-body
- ...
koa 相关知识,请自行学习。
重启,热加载
和前端一样,改了文件,会自动重启。
安装 nodemon:
npm install nodemon --save-dev
配置 package.json
scripts: { server: 'nodemon server-node/index.js' }
大概就这些了,有更好的建议或配置的,也请多多指教~~