环境主要依赖版本
- webpack@4.8.1
- webpack-cli@2.1.3
- webpack-dev-server@3.1.4
- react@16.3.2
- babel-core@6.26.3
- babel-preset-env@1.6.1
- bable-preset-react@6.24.1
webpack安装及配置
1. 起步
新建项目目录，初始化npm，新建开发源目录
mkdir webpack-react && cd webpack-reactnpm init -ymkdir src2.webpack-cli
webpack从4.x版本开始，需要同时安装webpack，webpack-cli(此工具用于在命令行中运行webpack)。
npm install webpack webpack-cli --save-dev3.wepback配置文件
在项目根目录新建webpack.config.js文件，此文件为webpack运行核心文件。
webpack.config.js 基本配置
// webpack.config.jsconst path = require('path');module.exports = { entry: './src/index.js', // 入口文件 output: { // webpack打包后出口文件 filename: 'app.js', // 打包后js文件名称 path: path.resolve(__dirname, 'dist') // 打包后自动输出目录 }}package.json 文件 s配置
" s": { "build": "webpack"}此时在命令行运行npm run build，就能执行webpack了，webpack会自动去找项目根目录里的webpack.config.js文件，执行打包。
npm run build// webpack打包后的项目├── dist│ └── app.js // 打包后的app.js├── package.json├── src│ └── index.js // 源目录入口文件└── webpack.config.jswebpack.config.js module相关配置
webpack 视所有文件都为模块，图片，css文件，字体等静态资源都会打包进js文件，所以会需要用到loader文件，更多Loaders可以查询网址，接下来我们安装一些必要的Loader文件。
npm install style-loader css-loader url-loader --save-devwebpack.config.js加入module模块
module.exports = { entry: './src/index.js', output: { filename: 'app.js', path: path.resolve(__dirname, 'dist') }, module: { rules: [ { test: /.css$/, use: ['style-loader', 'css-loader'] }, { test: /.(png|svg|jpg|gif)$/, use: ['url-loader'] }, { test: /.(woff|woff2|eot|ttf|otf)$/, use: ['url-loader'] } ] }}引入loader后，就可以在你的src/index.js文件import你想引入的css文件或者其他静态资源。
cd src && touch main.csssrc/index.js 文件引入css
import "./main.css";
webpack.config.js plugins配置
主要的js文件和静态文件都能成功打包成一个js文件后，我们需要把这个js文件放到html文件里，webpack插件***html-webpack-plugin***就是干这个事儿的，它能自动生成一个html文件并把我们打包好的js文件放入html。
npm install html-webpack-plugin --save-devwebpack.config.js 配置plugins
const path = require('path');const HtmlWebpackPlugin = require('html-webpack-plugin'); // 引入插件module.exports = { entry: './src/index.js', output: { filename: 'app.js', path: path.resolve(__dirname, 'dist') }, module: { rules: [ { test: /.css$/, use: ['style-loader', 'css-loader'] }, { test: /.(png|svg|jpg|gif)$/, use: ['url-loader'] }, { test: /.(woff|woff2|eot|ttf|otf)$/, use: ['url-loader'] } ] }, plugins: [ new HtmlWebpackPlugin({ : 'production'}) // 配置plugin ]};执行npm run build后，我们可以看到dist目录多出一个index.html文件。
<!DOCTYPE html><html> <head> < charset="UTF-8"> < >name</ > </head> <body> // 打包后的app.js已经被自动插入了html文件 < type="text/ " src="app.js"></ ></body></html>到这里，webpack最简单最基本的需求已经配置完毕。 此时项目结构为：
├── dist // 生产目录│ ├── app.js│ └── index.html├── package.json├── src // 源目录│ ├── index.js│ └── main.css└── webpack.config.jsReact 的webpack配置
安装react
安装react，wepback转换依赖
React组件由JSX组成，浏览器无法识别JSX，需要babel进行转换。
- babel-croe 为babel核心文件
- babel-preset-env 将ES6转义成ES5
- babel-preset-react 将JSX转义成js
- babel-loader webpack的babe转换
npm install babel-core babel-preset-env babel-preset-react babel-loader --save-dev.babelrc配置文件
在项目根目录下新建.babelrc文件，此文件为bable核心配置，babel会自动在项目根目录下识别。
// .babelrc{ "presets": ["env", "react"]}webpack babel-loader 配置
// 在webpack.config.js 的modules.rules中加入此配置{ test: /.(js|jsx)$/, exclude: /node_modules/, use: { loader: 'babel-loader' }} html-webpack-plugin 模板配置
我们知道react需要获取页面一个根元素，然后render才会生效，我们可以新建一个html文件，让html-webpack-plugin插件基于这个文件来进项打包。
所以我们在根目录下新建一个html文件，以此文件作模板。
// index.html<!DOCTYPE html><html lang="en"><head> < charset="UTF-8"> < >Document</ ></head><body> // react需要的渲染根元素 <div id="root"></div></body></html>此时webpack.config.js配置:
const path = require('path');const HtmlWebpackPlugin = require('html-webpack-plugin');module.exports = { entry: './src/index.js', output: { filename: 'app.js', path: path.resolve(__dirname, 'dist') }, module: { rules: [ { test: /.(js|jsx)$/, exclude: /node_modules/, use: { loader: 'babel-loader' } }, { test: /.css$/, use: ['style-loader', 'css-loader'] }, { test: /.(png|svg|jpg|gif)$/, use: ['url-loader'] }, { test: /.(woff|woff2|eot|ttf|otf)$/, use: ['url-loader'] } ] }, plugins: [ new HtmlWebpackPlugin({ : 'production', template: './index.html' // 模板文件位置 }) ]};书写React，运行webpack// src/index.jsimport React from 'react';import ReactDom from 'react-dom';import './main.css'ReactDom.render( <h1>hello world</h1>, document.getElementById('root'));运行npm run build，生成dist目录，打开dist目录中的index.html文件，可以发现浏览器已正常渲染"hello world"。
dev环境热更新配置
react的wepack完成以后，是不是发现每修改一次代码，想看到效果，得重新打包一次才行。webpack-dev-server配置可以帮助我们实现热更新，在开发环境解放我们的生产力。
安装webpack-dev-server
npm install webpack-dev-server --save-devwebpack.config.js 配置
const path = require('path');const HtmlWebpackPlugin = require('html-webpack-plugin');const webpack = require('webpack');module.exports = { entry: './src/index.js', output: { filename: 'app.js', path: path.resolve(__dirname, 'dist') }, module: { rules: [ { test: /.(js|jsx)$/, exclude: /node_modules/, use: { loader: 'babel-loader' } }, { test: /.css$/, use: ['style-loader', 'css-loader'] }, { test: /.(png|svg|jpg|gif)$/, use: ['url-loader'] }, { test: /.(woff|woff2|eot|ttf|otf)$/, use: ['url-loader'] } ] }, plugins: [ new HtmlWebpackPlugin({ : 'production', template: './index.html' }), // hot 检测文件改动替换plugin new webpack.NamedModulesPlugin(), new webpack.HotModuleReplacementPlugin() ], // webpack-dev-server 配置 devServer: { content : './dist', hot: true },};运行webpack-dev-server
在 package.json 文件 加入 s 配置：
" s": { "build": "webpack", "dev": "webpack-dev-server --open --mode development" // webpack-dev-server},命令行运行 npm run dev
可以在浏览器中输入localhost:8080 内容即为dist目录下的index.html内容。修改src/index.js中的内容或者依赖，即实时在浏览器热更新看到。
至此，react的webpack的基础开发环境已全部配置完毕。
原文发布时间为：2018年05月08日
原文作者： 会写代码的husky
本文来源：开源中国 如需转载请联系原作者
继续阅读与本文标签相同的文章
上一篇 :
一起学习造轮子（二）：从零开始写一个Redux
-
深度学习之视频人脸识别系列（一）：简介
2026-06-02栏目： 教程
-
H5页面滚动阻尼效果实现
2026-06-02栏目： 教程
-
基于mpvue开发微信小程序,vue能用的,用mpvue哪些情况不能用
2026-06-02栏目： 教程
-
linux下查看CPU、内存、磁盘信息
2026-06-02栏目： 教程
-
Promise 串行调用面试题
2026-06-02栏目： 教程