一、入门Webpack
参考文章:《入门Webpack,看这篇就够了》
耐心看完这篇非常有帮助
二、React+Webpack环境配置
参考文章:《webpack+react项目初体验》
项目实战:《webpack+react小项目》
三、webpack相关参数
1. entry参数
module.exports = { ... entry:__dirname + '/client/index',//打包入口文件 ... }/******* 例如可以是react渲染到组件的根js。 /client/index.js ReactDOM.render(<App />,document.getElementById('root') webpack从这个文件入手,获取层层的依赖包。index.js下的App.js,App.js下的.... __dirname:node.js中的一个全局变量,指向当前执行脚本所在的目录 ********/
2. output参数
var path = require('path');module.exports = { ... output: { path:path.join(__dirname + '/client/dist'), //打包后文件存放的位置 filename:'bundle.js' //打包后的文件名 } ... }
3. loaders参数
module.exports = { ... module :{ //配置ES6语法、React的loader loaders : [{ test :/(\.jsx|\.js)$/, exclude : /node_modules/, loader :'babel-loader', options:{ presets:[ "env", "react" ] } }, //配置css-loader { test : /\.css$/, loader:'style-loader!css-loader' }, //配置less-loader { test: /\.less/, loader: 'style-loader!css-loader!less-loader' }, ] }, ... }
4. html-webpack-plugin
const HtmlWebpackPlugin = require('html-webpack-plugin');module.exports = { ... //插件 plugins: [ ... //以该文件下的本地index.html作为模板,打包的时候自动生成服务器html并自动引入打包的js文件 new HtmlWebpackPlugin({ template: __dirname + "/client/views/index.html" }), ... ], ... }
四、package.json相关参数
1. script
"scripts": { "start": "node ./bin/www", //用npm run start 指代 node ./bin/www命令 启动服务 "build": "webpack" //用npm run build 指代 webpack 打包},
2. dependencies和devDependencies
区别
安装
npm install *** --save-dev //存进devDependencies 表示开发时依赖的插件(即不会打包至线上) npm install *** --save //存进dependencies,表示生产环境运行时所需要的包
归属模块dependencies:jquery...(打包项目依赖的包,缺少会报错) devDependencies:babel系列、webpack、React全家桶、less/sass-loader....(组件依赖一些框架或者比较大的包)
代码
"dependencies": { "cookie-parser": "~1.4.3", "debug": "~2.6.9", "ejs": "^2.6.1", "express": "~4.16.0", "http-errors": "~1.6.2", "jade": "~1.11.0", "morgan": "~1.9.0" }, "devDependencies": { "babel-core": "^6.26.3", "babel-loader": "^7.1.5", "babel-preset-env": "^1.7.0", "babel-preset-es2015": "^6.24.1", "babel-preset-react": "^6.24.1", "css-loader": "^1.0.0", "html-webpack-plugin": "^3.2.0", "less-loader": "^4.1.0", "react": "^16.4.2", "react-dom": "^16.4.2", "react-redux": "^5.0.7", "react-router-dom": "^4.3.1", "style-loader": "^0.22.1", "webpack": "^3.0.0", "webpack-cli": "^3.1.0", "webpack-dev-server": "^3.1.5" }
五、webpack增加热更新(实时更新)
1. 安装webpack-dev-server
npm install webpack-dev-server --save-dev
注意:如webpack-dev-server版本问题导致一个错误:
Error: invalid "instanceof" keyword value Promise
可安装该版本:npm install webpack-dev-server@2.9.7 --save-dev
2. 配置webpack.config.js
//webpack.config.jsmodule.exports = { ... //配置热更新 devServer: { historyApiFallback: true,//不跳转. hot: true, //是否启用模块热替换功能 inline: true,//实时更新 }, ... }
相关概念:
devServer.historyApiFallback:浏览器端的JavaScript代码会从URL里解析出当前的状态,显示对应的界面。
devServer.inline:配置是否自动注入这个代理客户端到将运行在页面的Chunk里面,默认是会自动注入。DevServer会根据你是否开启inline来调整它的自动刷新策略(刷新页面方式不一样)
1 如果开启inline,DevServer会在构建完变化后的代码时通过代理客户端控制网页刷新。
2 如果关闭inline,DevServer将无法直接控制要开发的网页。这时它会通过iframe的方式去运行要开发的网页,当构建完变化后的代码通过刷新iframe来实现实时预览。
3. 配置package.json
{ ... "scripts": { "start": "node ./bin/www", "build": "webpack-dev-server --hot --inline"//将webpack更换成webpack-dev-server --hot --inline }, ...
终端输入npm run build。访问相应端口即可实现热更新!
六、配置过程中遇到的问题
1. Webpack版本问题
终端输入:npm run build
error1:
Invalid configuration object. Webpack has been initialised using a configuration object that does not match the API schema.- configuration.module has an unknown property 'loaders'. These properties are valid:object { exprContextCritical?, exprContextRecursive?, exprContextRegExp?, exprContextRequest?, noParse?, rules?, defaultRules?, unknownContextCritical?, unknownContextRecursive?, unknownContextRegExp?, unknownContextRequest?, unsafeCache?, wrappedContextCritical?, wrappedContextRecursive?, wrappedContextRegExp?, strictExportPresence?, strictThisContextOnImports? }
-> Options affecting the normal modules (NormalModuleFactory
).
原因:webpack版本问题,无法解析'loaders'
解决:安装webpack的其他版本:
npm install webpack@3.0.0 --save-dev
或者
npm install webpack@2.1.0-beta.22 --save-dev
error2:
Module build failed: TypeError: fileSystem.statSync is not a function
原因:webpack版本不一致导致
解决:
npm install webpack@3.0.0 --save-dev
2. 模块安装问题
error1:
Module build failed: Error: Couldn't find preset "env" relative to directory
原因:配置的env需要babel-preset-env模块
解决:
npm install babel-preset-env --save-dev
error2:
Module build failed: Error: Illegal import declation
原因:使用babel解析es6失败
解决:
npm install babel-preset-es2015 --save-dev
3. 其他
error:
React+Webpack,打包成功后,node启动服务.无法访问编译后的文件。
打包后的index.html可以访问,但是bundle.js无法访问.本地直接打开可正常引入index.html和bundle.js.但开启服务访问,无法成功获得js.
原因:node配置静态文件目录指向错误. html文件引入目录配置正确,但js等静态文件引入目录配置错误
解决:
//引入html文件的目录指向app.engine('html', ejs.renderFile); app.set('views', path.join(__dirname, './client/dist')); //目录app.set('view engine', 'html');//引入css、js、img....等静态文件目录指向app.use(express.static(path.join(__dirname, './client/dist')));
原文出处:https://www.cnblogs.com/soyxiaobi/p/9451144.html