欢迎关注我的专栏( つ•̀ω•́)つ【人工智能通识】
【汇总】2019年4月专题
Webpack是目前最流行的Web开发模块化管理工具，这是一篇最基础的上手教程，包含了VSCode和Github项目设置。
人工智能通识-2019年3月专题汇总
前提工作
- 首先,你需要安装VSCode(Visual Studio Code)，这可以说是当今最流行的Web开发编码工具，它是开源免费的，由微软进行更新维护。
- 其次，你需要安装Git，然后在Github创建仓库Repository（我创建的是
GoCraft仓库）,然后在电脑上创建本地项目文件夹（我创建的是同名GoCraft文件夹），然后进入这个文件夹git init初始化本地Git仓库，然后git remote add origin https://username:password@github.com/...关联到远程的Github仓库，创建新文件如index.html，测试成功推送到本地Git和远程Github仓库。
- 最后，你需要安装
node.js。这是Web开发人员必备工具，它本来是用作后端开发的，但实际上前端的项目组织管理都离不开它，尤其是它包含的npm管理命令，稍后我们要一直用到。
初始化项目
进入你存放所有网页的文件夹（我的是GoCraft/cli)，然后执行npm init -y，这个npm命令是node.js安装包提供的。
这个命令为我们快速设置项目的信息，都写在package.json文件中。-y是自动设置，如果没有它你就需要输入很多内容或敲很多回车。
注意这里的main："index.js"，表示入口文件是index.js，它是所有代码的起始点。
安装webpack
webpack是用来管理各种web文件之间的关系的，能够有效地把各种js文件组织在一起，是当前最常用的模块化开发管理工具。
安装命令：
npm install webpack --save-dev
npm install webpack-cli --save-dev
这里的--save-dev是指把安装信息记录保存到开发环境设置中，建议所有安装都带着这个参数执行。webpack-cli是webpack的一个配套命令工具，稍后会用到它。
如果你安装比较慢，建议你先用管理员权限（苹果电脑下加sudo）安装淘宝的npm镜像：
npm install -g cnpm --registry=https://registry.npm.taobao.org，然后再用cnpm代替npm来执行cnpm install webpack --save-dev和cnpm install webpack-cli --save-dev
设置Git忽略文件夹
安装webpack的时候会导致Git出现数千个文件更改标记，这是因为在node_modules文件夹下产生数千个文件，而这些文件没必要放到Git仓库或者Github仓库中去，所以我们需要及时设置，让Git排除
node_modules文件夹。
在整个项目下(GoCraft目录而不是cli目录）下创建.gitignore文件，然后文件内添加要忽略的文件夹，这里只有一行:
cli/node_modules/
然后保存，退出Code重新启动，这时候就会看到Git需要提交的文件变成了很少的两三个。
创建index.html和index.js
作为浏览器的入口页面index.html是必不可少的，而作为main代码的入口页面index.js也是必不可少的。实际上网站的运行顺序是：
我们创建dist/index.html文件：
<!doctype html>
<html>
<head>
<title>Getting Started</title>
</head>
<body>
<script src="main.js"></script>
</body>
</html>
在这里我们引入一个还不存在的本地文件main.js，稍后它将由webpack根据index.js生成。
然后我们创建src文件夹下的src/index.js：
function component() {
let element = document.createElement('div');
element.innerHTML = "Hello World!"
return element;
}
document.body.appendChild(component());
然后我们需要修改一下package.json文件，添加一行"private": true,，去掉"main": "index.js",一行，这样将自动生成main.js而不会直接使用index.js。完整内容变为：
{
"name": "cli",
"version": "1.0.0",
"description": "",
"private": true,
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1"
},
"keywords": [],
"author": "",
"license": "ISC",
"devDependencies": {
"webpack": "^4.29.6",
"webpack-cli": "^3.3.0"
}
}
注意devDependencies开发依赖包，这个内容就是我们之前--save-dev产生的记录。
使用第三方包
安装第三方工具，这里我们使用lodash.js这个工具进行测试，它提供了一些列常用小功能。
cnpm install --save lodash
这个命令将把lodash安装到node_modules文件夹中待用。--save表示记录到生产环境（所以没有带-dev)
修改一下index.js使用我们的lodash：
import _ from 'lodash';
function component() {
let element = document.createElement('div');
element.innerHTML = _.join(['Hello', 'webpack'], ' ');
return element;
}
document.body.appendChild(component());
注意import xx from "XXX"就是从node_modules文件夹包含的第三方工具中调用功能，并且将这个功能重命名为xxx。所以下面直接使用了_.join功能。
然后执行npx webpack命令，这个命令将自动分析src/index.js，找到里面所有import导入的js模块文件，以及这些模块文件又可能导入的另外的模块文件，把这所有文件打包成dist/main.js,供index.html使用。
如果
npx webpack命令遇到错误cannot find module...，那么可以尝试重新用标准npm命令(而不是cnpm命令)安装，注意要使用管理员模式或者加sudo开始：
npm install webpack --save-dev
npm install webpack-cli --save-dev
npm install --save lodash
成功后生成的文件结构类似：
如果在浏览器手工打开index.html文件查看，将看到Hello webpack！字样。
自定义模块
创建cli/utils/hello.js文件，内容如下：
export default function hello() {
alert("I am hello module.")
}
然后在index.js中导入并使用它：
import _ from 'lodash';
import hello from './utils/hello';
function component() {
let element = document.createElement('div');
element.innerHTML = _.join(['Hello', 'webpack'], ' ');
hello()
return element;
}
document.body.appendChild(component());
再次执行npx webpack，然后打开index.html，正常就可以看到来自自定义模块的弹窗。
webpack.config.js设置文件
一般情况下webpack不需要额外设置，但可以在用项目根目录下创建webpack.config.js文件进行更多设置，例如：
const path = require('path');
module.exports = {
entry: './src/index.js',
output: {
filename: 'main.js',
path: path.resolve(__dirname, 'dist')
}
};
这里，entry: './src/index.js'指定了入口js文件，而ouput指定了npx webpack命令输出文件main.js的位置。
npx webpack和npm run build
我们可以通过修改package.json，用npm run build替换掉npx webpack命令(虽然这好像没啥意义)：
{
"name": "cli",
"version": "1.0.0",
"description": "",
"private": true,
"scripts": {
"test": "echo \"Error: no test specified\" && exit 1",
"build": "webpack"
},
"keywords": [],
"author": "",
"license": "ISC",
"devDependencies": {
"webpack": "^4.29.6",
"webpack-cli": "^3.3.0"
},
"dependencies": {
"lodash": "^4.17.11",
"resolve-cwd": "^2.0.0",
"resolve-from": "^4.0.0"
}
}
然后我们运行npm run build也能打包生成dist/main.js文件。
最终目录
最终目录结构看起来像这个样子：
你可以从我的Github项目中访问到完整代码：
更多扩展内容：关于如何在打包
main.js的时候支持ES6/7语法，你需要在webpack.conf.js安装和配置相应的loader工具。关于如何实现保存文件时候自动打包，你需要安装和配置webpack-dev-server。具体内容在这里暂时不扩展了。
欢迎关注我的专栏( つ•̀ω•́)つ【人工智能通识】
每个人的智能新时代
如果您发现文章错误，请不吝留言指正；
如果您觉得有用，请点喜欢；
如果您觉得很有用，欢迎转载~
END
