Vue2.0 新手完全填坑攻略—从环境搭建到发布
zeopha
8年前
<p><img src="https://simg.open-open.com/show/2abd7db097de6143706760e29002075f.png"></p> <h2><strong>什么是 Vue</strong></h2> <p>Vue 是一个前端框架，特点是</p> <p><strong>数据绑定</strong></p> <p>比如你改变一个输入框 Input 标签的值，会 <strong>自动同步</strong> 更新到页面上其他绑定该输入框的组件的值</p> <p></p> <p style="text-align:center"><img src="https://simg.open-open.com/show/c3e294cb5912db7339b5e4c62e8309c9.png"></p> <p><strong>组件化</strong></p> <p>页面上小到一个按钮都可以是一个单独的文件.vue，这些小组件直接可以像乐高积木一样通过互相引用而组装起来</p> <p><img src="https://simg.open-open.com/show/b356c02ae60c8214071dec669bb17ca9.jpg"> </p> <h2><strong>Vue2.0 推荐开发环境</strong></h2> <p></p> <p style="text-align: center;"><img src="https://simg.open-open.com/show/c3bc1e69f6da91b2026dd5bbd75e447e.png"></p> <p>Homebrew 1.0.6(Mac)、Node.js 6.7.0、npm 3.10.3、webpack 1.13.2、vue-cli 2.4.0、Atom 1.10.2</p> <h2><strong>安装环境</strong></h2> <p>打开终端运行以下命令</p> <h2><strong>安装brew</strong></h2> <pre> <code class="language-javascript">/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"</code></pre> <h2><strong>安装 nodejs</strong></h2> <p>brew install nodejs</p> <p>用 npm install npm@3.10.3 更新 npm 版本报错:</p> <p>(node:42) fs: re-evaluating native module sources is not supported.</p> <p>解决办法:在官网下载6.70的安装包再安装一次(刚刚相当于帮你配置好环境变量，现在再安装一次升级到最新的 npm)</p> <ul> <li> <p>好像以前官网的安装包不会自动配置环境变量的，由于我电脑上之前安装过 nodejs 所以环境变量已经配置好了，不知道现在的安装包会不会自动配置环境变量。</p> </li> </ul> <p>Windows 下直接下载安装包即可</p> <h2><strong>获取nodejs模块安装目录访问权限</strong></h2> <pre> <code class="language-javascript">sudo chmod -R 777 /usr/local/lib/node_modules/</code></pre> <h2><strong>安装淘宝镜像</strong></h2> <p>npm install -g cnpm --registry= <a href="/misc/goto?guid=4959672280956016232" rel="nofollow,noindex">https://registry.npm.taobao.org</a></p> <h2><strong>安装webpack</strong></h2> <p>cnpm install webpack -g</p> <h2><strong>安装vue脚手架</strong></h2> <p>npm install vue-cli -g</p> <h2><strong>在硬盘上找一个文件夹放工程用的，在终端中进入该目录</strong></h2> <p>Mac</p> <p>cd 目录路径</p> <h2><strong>根据模板创建项目</strong></h2> <p>vue init webpack-simple 工程名字<工程名字不能用中文></p> <p>或者创建 vue1.0 的项目</p> <p>vue init webpack-simple#1.0 工程名字<工程名字不能用中文></p> <p>会有一些初始化的设置，如下输入:</p> <p>Target directory exists. Continue? (Y/n) 直接回车默认(然后会下载 vue2.0模板，这里可能需要连代理)</p> <p>Project name (vue-test) 直接回车默认</p> <p>Project description (A Vue.js project) 直接回车默认</p> <p>Author 写你自己的名字</p> <h2><strong>cd 命令进入创建的工程目录</strong></h2> <p>工程目录如图所示:</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/6bd3fe0e9d66ba878544402c9c4f12f4.jpg"></p> <h2><strong>安装项目依赖</strong></h2> <p>一定要从官方仓库安装，npm 服务器在国外所以这一步安装速度会很慢。</p> <p>npm install</p> <p>不要从国内镜像cnpm安装(会导致后面缺了很多依赖库)</p> <p>cnpm install</p> <h2><strong>安装 vue 路由模块 vue-router 和网络请求模块 vue-resource</strong></h2> <p>cnpm install vue-router vue-resource --save</p> <h2><strong>启动项目</strong></h2> <p>npm run dev</p> <h3><strong>填坑(以下坑可能由于 vue2.0 导致其他相关编译打包工具没更新导致的)</strong></h3> <p>【重点】后来发现这些坑是由于 npm 不是最新的版本3.10.2， 用 npm 3.9.5就会出现以下坑</p> <p>解决办法: 请运行以下命令</p> <p>npm update -g</p> <p>报错</p> <p>Error: Cannot find module 'opn'</p> <p>Error: Cannot find module 'webpack-dev-middleware'</p> <p>Error: Cannot find module 'express'</p> <p>Error: Cannot find module 'compression'</p> <p>Error: Cannot find module 'sockjs'</p> <p>Error: Cannot find module 'spdy'</p> <p>Error: Cannot find module 'http-proxy-middleware'</p> <p>Error: Cannot find module 'serve-index'</p> <p>如果你用的是老版本的 vue-cli 还可能报其他错误，需要更新一下 vue-cli</p> <p>npm update vue-cli</p> <p>然后可以查看一下当前全局 vue-cli 的版本</p> <p>npm view vue-cli</p> <p>安装一下这个依赖到工程开发环境</p> <p>cnpm install opn --save-dev</p> <p>cnpm install webpack-dev-middleware --save-dev</p> <p>cnpm install express --save-dev</p> <p>cnpm install compression --save-dev</p> <p>cnpm install sockjs --save-dev</p> <p>cnpm install spdy --save-dev</p> <p>cnpm install http-proxy-middleware --save-dev</p> <p>cnpm install serve-index --save-dev</p> <p>cnpm install connect-history-api-fallback --save-dev</p> <p>再启动项目，报错</p> <p>ERROR in ./src/main.js</p> <p>Module build failed: Error: Cannot find module 'babel-runtime/helpers/typeof'</p> <pre> <code class="language-javascript">at Function.Module._resolveFilename (module.js:440:15) at Function.Module._load (module.js:388:25) at Module.require (module.js:468:17) at require (internal/module.js:20:19) at Object.<anonymous> (/Volumes/MacStorage/Coding/Web/vue-test/node_modules/.6.17.0@babel-core/lib/transformation/file/index.js:6:16) at Module._compile (module.js:541:32) at Object.Module._extensions..js (module.js:550:10) at Module.load (module.js:458:32) at tryModuleLoad (module.js:417:12) at Function.Module._load (module.js:409:3)</code></pre> <p>@ multi main</p> <p>ERROR in ./~/.2.1.0-beta.8@webpack-dev-server/client/socket.js</p> <p>Module not found: Error: Can't resolve 'sockjs-client' in '/Volumes/MacStorage/Coding/Web/vue-test/node_modules/.2.1.0-beta.8@webpack-dev-server/client'</p> <p>@ ./~/.2.1.0-beta.8@webpack-dev-server/client/socket.js 1:13-37</p> <p>@ ./~/.2.1.0-beta.8@webpack-dev-server/client? <a href="/misc/goto?guid=4958965640789895086" rel="nofollow,noindex">http://localhost:8080</a></p> <p>@ multi main</p> <p>安装一下 babel-runtime</p> <p>cnpm install babel-helpers --save-dev</p> <p>启动项目，再次报错</p> <p>Module build failed: Error: Cannot find module 'babel-helpers'</p> <p>Module build failed: Error: Cannot find module 'babel-traverse'</p> <p>Module build failed: Error: Cannot find module 'json5'</p> <p>Module build failed: Error: Cannot find module 'babel-generator'</p> <p>Module build failed: Error: Cannot find module 'detect-indent'</p> <p>Module build failed: Error: Cannot find module 'jsesc'</p> <p>找不到依赖那就再安装一下</p> <p>cnpm install babel-helpers --save-dev</p> <p>cnpm install babel-traverse --save-dev</p> <p>cnpm install json5 --save-dev</p> <p>. ..不写了，请把全部把旧的环境全部清除，更新到最新版本</p> <h3><strong>解决办法概述</strong></h3> <p>遇到</p> <p>Module build failed: Error: Cannot find module '模块名'</p> <p>那就安装</p> <p>cnpm install 模块名 --save-dev(关于环境的，表现为npm run dev 启动不了)</p> <p>cnpm install 模块名 --save(关于项目的，比如main.js，表现为npm run dev 成功之后控制台报错)</p> <p>比如escape-string-regexp、strip-ansi、has-ansi、is-finite、emojis-list</p> <h3><strong>终于可以启动项目了</strong></h3> <p>输入完命令会自动启动浏览器，如果默认打开 IE 不行</p> <p>npm run dev</p> <p>自动启动浏览器就会看到这 帅帅的界面了。</p> <p style="text-align: center;"><img src="https://simg.open-open.com/show/b021f6f435f9f80e95b44ebb39fd5eb0.png"></p> <h2><strong>开始 Vue 之旅</strong></h2> <h2><strong>打开 IDE</strong></h2> <p>推荐 Atom 打开项目，需要安装 Vue 语法高亮的插件</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/d2b2e67f56ddeffad4e2af0902bda0f0.jpg"></p> <h2><strong>使用官网文档学习基础</strong></h2> <p>我们来看官网的一个例子，(中文文档请自行上网搜索)</p> <p> <img src="https://simg.open-open.com/show/2c155b709b0b460333dcb607df191243.jpg"></p> <p>打开 工程目录下的 App.vue</p> <p>template 写 html，script写 js，style写样式</p> <p><img src="https://simg.open-open.com/show/2e42354ba38d382b8eb93f7c48d63c23.jpg"></p> <p>为了方便叙述，我们把官网例子写在同一个组件内</p> <p>这里有两个坑:</p> <p>第一。一个组件下只能有一个并列的 div，可以这么写，所以复制官网示例的时候只要复制 div 里面的内容就好。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/f2c62161d9021a954198f540882b9139.jpg"></p> <p>但是不能这样写:</p> <p style="text-align:center"> <img src="https://simg.open-open.com/show/0f8c4a79499b182fd9a5f7486a98e408.jpg"></p> <p>第二。数据要写在 return 里面而不是像文档那样子写</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/d1cefb75e1256abbc2dafbf6576ce795.jpg"></p> <p>错误的写法:</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/42ae6f7197563d2593d4f355bc85e1f2.jpg"></p> <p>这样子可以自己啃完官网文档组件之前的部分了。</p> <p style="text-align:center"><img src="https://simg.open-open.com/show/1a31b94678902b4f3147db0a8f4ce091.png"></p> <h2><strong>来玩玩组件</strong></h2> <p>前面讲得基本上都是各种常用组件的数据绑定，下面还得说说的是 Vue 的组件的使用。</p> <p>在工程目录 /src 下创建 component 文件夹，并在 component 文件夹下创建一个 firstcomponent.vue 并写仿照 App.vue 的格式和前面学到的知识写一个组件。</p> <pre> <code class="language-javascript"><template> <div id="firstcomponent"> <h1>I am a title.</h1> <a> written by {{ author }} </a> </div> </template> <script type="text/javascript"> export default { data () { return { author: "微信公众号 jinkey-love" } } } </script> <style> </style></code></pre> <p>duang... 不能按官网文档那样子叫我做就做，我得先试试再告诉你，我做完效果是这样子的，希望观众做完也是这样子。(迷之微笑 )</p> <p><img src="https://simg.open-open.com/show/5ce98ff2a2a69d454e4ab3ee08aedba7.jpg"></p> <p>然后在 App.vue 使用组件 ( 因为在 index.html 里面定义了<div id="app"></div>所以就以这个组件作为主入口，方便 )</p> <p>第一步，引入。在 <script></script> 标签内的第一行写</p> <pre> <code class="language-javascript">import firstcomponent from './component/firstcomponent.vue'</code></pre> <p>第二步，注册。在 <script></script> 标签内的 data 代码块后面加上 components: { firstcomponent }。 <strong>记得中间加英文逗号!!!</strong></p> <pre> <code class="language-javascript">export default { data () { return { msg: 'Hello Vue!' } }, components: { firstcomponent } }</code></pre> <p>第三步，使用。</p> <p>在 <template></template> 内加上<firstcomponent></firstcomponent></p> <pre> <code class="language-javascript"><template> <div id="app"> <img src="./assets/logo.png"> <h1>{{ msg }}</h1> <firstcomponent></firstcomponent> </div> </template></code></pre> <p>完成后的代码：</p> <p><img src="https://simg.open-open.com/show/8dd4cb4fd6d443bf1223a348df56568d.jpg"></p> <p>这时候看看浏览器上的 http://localhost:8080/ 页面(之前打开过就会自动刷新)，如果你没看到效果是因为你没有对 App.vue 和 firstcomponent.vue 进行保存操作，保存后页面会自动刷新。</p> <p style="text-align: center;"><img src="https://simg.open-open.com/show/0ff8ebd7751fd5139d85118c09eb5fd0.png"></p> <h2><strong>使用路由搭建单页应用</strong></h2> <p>之前已经通过命令安装了vue-router</p> <p>cnpm install vue-router --save</p> <p>在 webpack.config.js 加入别名</p> <pre> <code class="language-javascript">resolve: { alias: {vue: 'vue/dist/vue.js'} }</code></pre> <p>为什么要加 alias 配置项？其作用可以在文档中有相应的描述:</p> <p><img src="https://simg.open-open.com/show/20bc08689aed11e9ad5dd05ca93f8f38.jpg"></p> <p>修改完之后的 webpack.config.js 是这样子的:</p> <pre> <code class="language-javascript">var path = require('path') var webpack = require('webpack') module.exports = { entry: './src/main.js', output: { path: path.resolve(__dirname, './dist'), publicPath: '/dist/', filename: 'build.js' }, resolveLoader: { root: path.join(__dirname, 'node_modules'), }, module: { loaders: [ { test: /\\.vue$/, loader: 'vue' }, { test: /\\.js$/, loader: 'babel', exclude: /node_modules/ }, { test: /\\.(png|jpg|gif|svg)$/, loader: 'file', query: { name: '[name].[ext]?[hash]' } } ] }, resolve: { alias: {vue: 'vue/dist/vue.js'} }, devServer: { historyApiFallback: true, noInfo: true }, devtool: '#eval-source-map' } if (process.env.NODE_ENV === 'production') { module.exports.devtool = '#source-map' // http://vue-loader.vuejs.org/en/workflow/production.html module.exports.plugins = (module.exports.plugins || []).concat([ new webpack.DefinePlugin({ 'process.env': { NODE_ENV: '"production"' } }), new webpack.optimize.UglifyJsPlugin({ compress: { warnings: false } }) ]) }</code></pre> <p>再按之前的方法写一个组件 secondcomponent.vue</p> <pre> <code class="language-javascript"><template> <div id="secondcomponent"> <h1>I am another page</h1> <a> written by {{ author }} </a> <p> 感谢 <a href="https://github.com/showonne">showonne</a>大神的技术指导</p> </div> </template> <script> export default { data() { return { author: "微信公众号 jinkey-love", articles: [], } } } } </script> <style> </style></code></pre> <p>这时候修改 main.js，引入并注册 vue-router</p> <pre> <code class="language-javascript">import VueRouter from "vue-router"; Vue.use(VueRouter);</code></pre> <p>并且配置路由规则和 app 启动配置项加上 router，旧版的 router.map 方法在 vue-router 2.0 已经不能用了。修改后的 main.js 如下:</p> <pre> <code class="language-javascript">import Vue from 'vue' import App from './App.vue' import VueRouter from "vue-router"; import VueResource from 'vue-resource' //开启debug模式 Vue.config.debug = true; Vue.use(VueRouter); Vue.use(VueResource); // 定义组件, 也可以像教程之前教的方法从别的文件引入 const First = { template: '<div><h2>我是第 1 个子页面</h2></div>' } import secondcomponent from './component/secondcomponent.vue' // 创建一个路由器实例 // 并且配置路由规则 const router = new VueRouter({ mode: 'history', base: __dirname, routes: [ { path: '/first', component: First }, { path: '/second', component: secondcomponent } ] }) // 现在我们可以启动应用了！ // 路由器会创建一个 App 实例，并且挂载到选择符 #app 匹配的元素上。 const app = new Vue({ router: router, render: h => h(App) }).$mount('#app')</code></pre> <p>这样子改完再打开浏览器看看。</p> <p style="text-align: center;"><img src="https://simg.open-open.com/show/2e49967a283e2d820e2e42b7f5cee5ae.png"></p> <p>点击那两个链接试试，会发现 <router-view class="view"></router-view> 的内容已经展示出来，同时注意 <strong>浏览器地址已经变更</strong> 。</p> <p style="text-align: center;"><img src="https://simg.open-open.com/show/d2f211614c9662d3eb8ba3ce308888d6.png"></p> <p>另外，也可以把 App.vue 的内容写在 main.js 也是可以的不过不建议这么做</p> <p><img src="https://simg.open-open.com/show/5690b2fd59e627d85cf99f96a22beb7c.jpg"></p> <p>如果你使用 vue1.0和0.7版本的 vue-router，请参照下面这个教程, 他整个系列都不错的，当然仅限于 vue1.0 :</p> <h2><strong>给页面加点动态数据</strong></h2> <p>这时候的页面都是静态的(数据在写程序的时候已经固定了不能修改)，而每个应用基本上都会请求外部数据以动态改变页面内容。对应有一个库叫 vue-resource 帮我们解决这个问题。</p> <p>使用命令行安装</p> <p>cnpm install vue-resource --save</p> <p>在 main.js 引入并注册 vue-resource :</p> <pre> <code class="language-javascript">import VueResource from 'vue-resource' Vue.use(VueResource);</code></pre> <p>我们在 secondcomponent.vue 上来动态加载数据</p> <p>添加一个列表:</p> <pre> <code class="language-javascript"><ul> <li v-for="article in articles"> {{article.title}} </li> </ul></code></pre> <p>在 data 里面加入数组 articles 并赋值为[]</p> <p>然后在 data 后面加入加入钩子函数 mounted (详细请参照官方文档关于 vue 生命周期的解析)， <strong>data 和 mount 中间记得记得加逗号</strong></p> <pre> <code class="language-javascript">mounted: function() { this.$http.jsonp('https://api.douban.com/v2/movie/top250?count=10', {}, { headers: { }, emulateJSON: true }).then(function(response) { // 这里是处理正确的回调 this.articles = response.data.subjects // this.articles = response.data["subjects"] 也可以 }, function(response) { // 这里是处理错误的回调 console.log(response) }); }</code></pre> <p>这里使用的是豆瓣的公开 GET 接口，如果接口是跨域的 POST 请求，则需要在服务器端配置:</p> <p>Access-Control-Allow-Origin: *</p> <p>这时候运行看看。等一会接口返回数据，咦，数据加载出来了，棒棒哒 !</p> <p style="text-align: center;"><img src="https://simg.open-open.com/show/6fa9bb7fa78a0ace377ba5769ab6f83c.png"></p> <h2><strong>来拯救如此难看的界面</strong></h2> <p>组件、双向绑定、路由、数据请求等基本特性都能用了，写到这里一个单页应用基本上成型了。但是，这几面也太 TM 难看了吧。自己写 UI 框架太费劲？那就上网找一个吧。</p> <p>本来想给大家介绍 Vux 的，因为他用的是微信的 WeUI 设计规范，对于开发微信小程序或者微信内的网页非常和谐，但由于写这篇文章的时候 Vux 还不支持 vue2.0，只能用别的框架了。</p> <p>命令行安装 ElementUI (此处某公司的人应该发红包了...)</p> <p>cnpm install element-ui@next -S</p> <p>然后在 main.js 引入并注册</p> <pre> <code class="language-javascript">import Element from 'element-ui' import 'element-ui/lib/theme-default/index.css' Vue.use(Element)</code></pre> <p>保存，这时候程序报错</p> <p>Uncaught Error: Module parse failed: /Users/**/Desktop/vue2/node_modules/.1.0.0-rc.5@element-ui/lib/theme-default/index.css Unexpected character '@' (1:0)</p> <p>You may need an appropriate loader to handle this file type.</p> <p>官网文档又有坑了，安装教程也不跟我们说这一步，当我们都是高手了...</p> <p>报错是由于我们引入了 index.css 这个 CSS 文件，但是 webpack 打包的时候无法识别并转换成 js，所以就需要配置才能读取 css 和字体文件，运行命令安装下面三个东西(如果之前安装过就不需要了)</p> <p>cnpm install style-loader --save-dev</p> <p>cnpm install css-loader --save-dev</p> <p>cnpm install file-loader --save-dev</p> <p>在 webpack.config.js 中的 loaders 数组加入以下配置， <strong>记得该加逗号的地方加逗号!</strong></p> <pre> <code class="language-javascript">{ test: /\\.css$/, loader: "style!css" }, { test: /\\.(eot|woff|woff2|ttf)([\\?]?.*)$/, loader: "file" }</code></pre> <p>修改完的 webpack.config.js 如下</p> <pre> <code class="language-javascript">var path = require('path') var webpack = require('webpack') module.exports = { entry: './src/main.js', output: { path: path.resolve(__dirname, './dist'), publicPath: '/dist/', filename: 'build.js' }, resolveLoader: { root: path.join(__dirname, 'node_modules'), }, module: { loaders: [ { test: /\\.vue$/, loader: 'vue' }, { test: /\\.js$/, loader: 'babel', exclude: /node_modules/ }, { test: /\\.css$/, loader: "style!css" }, { test: /\\.(eot|woff|woff2|ttf)([\\?]?.*)$/, loader: "file" }, { test: /\\.(png|jpg|gif|svg)$/, loader: 'file', query: { name: '[name].[ext]?[hash]' } } ] }, resolve: { alias: {vue: 'vue/dist/vue.js'} }, devServer: { historyApiFallback: true, noInfo: true }, devtool: '#eval-source-map' } if (process.env.NODE_ENV === 'production') { module.exports.devtool = '#source-map' // http://vue-loader.vuejs.org/en/workflow/production.html module.exports.plugins = (module.exports.plugins || []).concat([ new webpack.DefinePlugin({ 'process.env': { NODE_ENV: '"production"' } }), new webpack.optimize.UglifyJsPlugin({ compress: { warnings: false } }) ]) }</code></pre> <p>给豆瓣的电影列表套个衣服(样式) :</p> <pre> <code class="language-javascript"><el-card class="box-card"> <div slot="header" class="clearfix"> <h1 style="line-height: 36px; color: #20A0FF">豆瓣电影排行榜</h2> </div> <div v-for="article in articles" class="text item"> {{article.title}} </div> </el-card></code></pre> <p>打开浏览器,输入网址:</p> <p><a href="/misc/goto?guid=4959720222590430403" rel="nofollow,noindex">http://localhost:8080/second</a></p> <p style="text-align: center;"><img src="https://simg.open-open.com/show/3f4adec6a68590584063bf5beae517e0.png"></p> <p></p> <p>列表比之前漂亮多了，你还可以参照 ElementUI 的文档使用更多组件样式</p> <h2><strong>编译</strong></h2> <p>npm run build</p> <p>又报错了...orz</p> <p>ERROR in build.js from UglifyJs</p> <p>SyntaxError: Unexpected token punc «(», expected punc «:» [build.js:32001,6]</p> <p>把node_modules/.bin/cross-env里的</p> <p>require('../dist')(process.argv.slice(2));</p> <p>后来发现直接运行 webpack 命令就可以打包了</p> <p>webpack --color --progress</p> <p>接着把 index.html 和整个 dist 目录丢到服务器就可以了。</p> <p> </p> <p> </p> <p> </p> <p>来自：https://segmentfault.com/a/1190000007124470</p> <p> </p>