VUE 新手環境搭建-釋出

阿新 • • 發佈：2019-01-07

什麼是 Vue

Vue 是一個前端框架，特點是
資料繫結

比如你改變一個輸入框 Input 標籤的值，會自動同步更新到頁面上其他繫結該輸入框的元件的值

資料繫結

元件化

頁面上小到一個按鈕都可以是一個單獨的檔案.vue，這些小元件直接可以像樂高積木一樣通過互相引用而組裝起來

元件化

Vue2.0 推薦開發環境

開發環境解釋

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

安裝環境

開啟終端執行以下命令

安裝brew

/usr/bin/ruby -e "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install)"

安裝 nodejs

brew install nodejs

用 npm install [email protected] 更新 npm 版本報錯:

(node:42) fs: re-evaluating native module sources is not supported.

解決辦法:
在官網下載6.70的安裝包再安裝一次(剛剛相當於幫你配置好環境變數，現在再安裝一次升級到最新的 npm)

好像以前官網的安裝包不會自動配置環境變數的，由於我電腦上之前安裝過 nodejs 所以環境變數已經配置好了，不知道現在的安裝包會不會自動配置環境變數。

Windows 下直接下載安裝包即可

獲取nodejs模組安裝目錄訪問許可權

sudo chmod -R 777 /usr/local/lib/node_modules/

安裝淘寶映象

安裝webpack

cnpm install webpack -g

安裝vue腳手架

npm install vue-cli -g

在硬碟上找一個資料夾放工程用的，在終端中進入該目錄

Mac

cd 目錄路徑

根據模板建立專案

vue init webpack-simple 工程名字<工程名字不能用中文>
或者建立 vue1.0 的專案
vue init webpack-simple#1.0 工程名字<工程名字不能用中文>

會有一些初始化的設定，如下輸入:
Target directory exists. Continue? (Y/n)直接回車預設(然後會下載 vue2.0模板，這裡可能需要連代理)
Project name (vue-test)直接回車預設
Project description (A Vue.js project) 直接回車預設
Author 寫你自己的名字

cd 命令進入建立的工程目錄

工程目錄如圖所示:

安裝專案依賴

一定要從官方倉庫安裝，npm 伺服器在國外所以這一步安裝速度會很慢。

npm install

不要從國內映象cnpm安裝(會導致後面缺了很多依賴庫)

cnpm install

安裝 vue 路由模組`vue-router`和網路請求模組`vue-resource`

cnpm install vue-router vue-resource --save

啟動專案

npm run dev

填坑(以下坑可能由於 vue2.0 導致其他相關編譯打包工具沒更新導致的)

【重點】後來發現這些坑是由於 npm 不是最新的版本3.10.2，用 npm 3.9.5就會出現以下坑
解決辦法: 請執行以下命令
npm update -g

報錯

Error: Cannot find module 'opn'
Error: Cannot find module 'webpack-dev-middleware'
Error: Cannot find module 'express'
Error: Cannot find module 'compression'
Error: Cannot find module 'sockjs'
Error: Cannot find module 'spdy'
Error: Cannot find module 'http-proxy-middleware'
Error: Cannot find module 'serve-index'

如果你用的是老版本的 vue-cli 還可能報其他錯誤，需要更新一下 vue-cli

npm update vue-cli

然後可以檢視一下當前全域性 vue-cli 的版本

npm view vue-cli

安裝一下這個依賴到工程開發環境

cnpm install opn --save-dev
cnpm install webpack-dev-middleware --save-dev
cnpm install express --save-dev
cnpm install compression --save-dev
cnpm install sockjs --save-dev
cnpm install spdy --save-dev
cnpm install http-proxy-middleware --save-dev
cnpm install serve-index --save-dev
cnpm install connect-history-api-fallback --save-dev

再啟動專案，報錯

ERROR in ./src/main.js
Module build failed: Error: Cannot find module 'babel-runtime/helpers/typeof'
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/[email protected]/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)
@ multi main
ERROR in ./~/[email protected]/client/socket.js
Module not found: Error: Can't resolve 'sockjs-client' in '/Volumes/MacStorage/Coding/Web/vue-test/node_modules/[email protected]/client'
@ ./~/[email protected]/client/socket.js 1:13-37
@ ./~/[email protected]/client?http://localhost:8080
@ multi main

安裝一下 babel-runtime

cnpm install babel-helpers --save-dev

啟動專案，再次報錯

Module build failed: Error: Cannot find module 'babel-helpers'
Module build failed: Error: Cannot find module 'babel-traverse'
Module build failed: Error: Cannot find module 'json5'
Module build failed: Error: Cannot find module 'babel-generator'
Module build failed: Error: Cannot find module 'detect-indent'
Module build failed: Error: Cannot find module 'jsesc'

找不到依賴那就再安裝一下

cnpm install babel-helpers --save-dev
cnpm install babel-traverse --save-dev
cnpm install json5 --save-dev
...不寫了，請把全部把舊的環境全部清除，更新到最新版本

解決辦法概述

遇到

Module build failed: Error: Cannot find module '模組名'

那就安裝

cnpm install 模組名 --save-dev(關於環境的，表現為npm run dev 啟動不了)
cnpm install 模組名 --save(關於專案的，比如main.js，表現為npm run dev 成功之後控制檯報錯)
比如escape-string-regexp、strip-ansi、has-ansi、is-finite、emojis-list

終於可以啟動專案了

輸入完命令會自動啟動瀏覽器，如果預設開啟 IE 不行

npm run dev

自動啟動瀏覽器就會看到這帥帥的介面了。

開始 Vue 之旅

開啟 IDE

推薦 Atom 開啟專案，需要安裝 Vue 語法高亮的外掛

使用官網文件學習基礎

我們來看官網的一個例子，(中文文件請自行上網搜尋)

開啟工程目錄下的 App.vue
template 寫 html，script寫 js，style寫樣式

為了方便敘述，我們把官網例子寫在同一個元件內
這裡有兩個坑:
第一。一個元件下只能有一個並列的 div，可以這麼寫，所以複製官網示例的時候只要複製 div 裡面的內容就好。

但是不能這樣寫:

第二。資料要寫在 return 裡面而不是像文件那樣子寫

錯誤的寫法:

這樣子可以自己啃完官網文件元件之前的部分了。

來玩玩元件

前面講得基本上都是各種常用元件的資料繫結，下面還得說說的是 Vue 的元件的使用。
在工程目錄/src下建立component資料夾，並在component資料夾下建立一個 firstcomponent.vue並寫仿照 App.vue 的格式和前面學到的知識寫一個元件。

<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>

duang... 不能按官網文件那樣子叫我做就做，我得先試試再告訴你，我做完效果是這樣子的，希望觀眾做完也是這樣子。(迷之微笑 )

然後在 App.vue 使用元件 ( 因為在 index.html 裡面定義了<div id="app"></div>所以就以這個元件作為主入口，方便 )
第一步，引入。在<script></script>標籤內的第一行寫

import firstcomponent from './component/firstcomponent.vue'

第二步，註冊。在<script></script>標籤內的 data 程式碼塊後面加上 components: { firstcomponent }。記得中間加英文逗號!!!

export default {
  data () {
    return {
      msg: 'Hello Vue!'
    }
  },
  components: { firstcomponent }
}

第三步，使用。
在<template></template>內加上<firstcomponent></firstcomponent>

<template>
  <div id="app">
    <img src="./assets/logo.png">
    <h1>{{ msg }}</h1>
    <firstcomponent></firstcomponent>
  </div>
</template>

完成後的程式碼：

這時候看看瀏覽器上的 http://localhost:8080/ 頁面(之前開啟過就會自動重新整理)，如果你沒看到效果是因為你沒有對 App.vue 和 firstcomponent.vue 進行儲存操作，儲存後頁面會自動重新整理。

使用路由搭建單頁應用

之前已經通過命令安裝了vue-router

cnpm install vue-router --save

在webpack.config.js加入別名

resolve: {
    alias: {vue: 'vue/dist/vue.js'}
  }

為什麼要加 alias 配置項？其作用可以在文件中有相應的描述:

修改完之後的webpack.config.js是這樣子的:

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
      }
    })
  ])
}

再按之前的方法寫一個元件 secondcomponent.vue

<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>

這時候修改 main.js，引入並註冊 vue-router

import VueRouter from "vue-router";
Vue.use(VueRouter);

並且配置路由規則和 app 啟動配置項加上 router，舊版的 router.map 方法在 vue-router 2.0 已經不能用了。修改後的main.js如下:

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')

這樣子改完再開啟瀏覽器看看。

點選那兩個連結試試，會發現<router-view class="view"></router-view>的內容已經展示出來，同時注意瀏覽器地址已經變更。

另外，也可以把 App.vue 的內容寫在 main.js 也是可以的不過不建議這麼做

如果你使用 vue1.0和0.7版本的 vue-router，請參照下面這個教程, 他整個系列都不錯的，當然僅限於 vue1.0 :

給頁面加點動態資料

這時候的頁面都是靜態的(資料在寫程式的時候已經固定了不能修改)，而每個應用基本上都會請求外部資料以動態改變頁面內容。對應有一個庫叫 vue-resource 幫我們解決這個問題。
使用命令列安裝

cnpm install vue-resource --save

在 main.js 引入並註冊 vue-resource:

import VueResource from 'vue-resource'
Vue.use(VueResource);

我們在 secondcomponent.vue 上來動態載入資料
新增一個列表:

<ul>
      <li v-for="article in articles">
        {{article.title}}
      </li>
    </ul>

在 data 裡面加入陣列 articles 並賦值為[]
然後在 data 後面加入加入鉤子函式 mounted(詳細請參照官方文件關於 vue 生命週期的解析)，data 和 mount 中間記得記得加逗號

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)
    });
  }

這裡使用的是豆瓣的公開 GET 介面，如果介面是跨域的 POST 請求，則需要在伺服器端配置:

Access-Control-Allow-Origin: *

這時候執行看看。等一會介面返回資料，咦，資料加載出來了，棒棒噠 !