开发环境搭建

开始 Vue 开发之前,需要搭建合适的开发环境。本章介绍几种不同的方式,从最简单的 CDN 引入到完整的工程化配置。

方式一:CDN 直接引入

最简单的方式,适合学习和简单项目。

<!DOCTYPE html>
<html>
<head>
  <title>Vue Demo</title>
</head>
<body>
  <div id="app">
    {{ message }}
  </div>

  <!-- 开发版本,包含控制台警告 -->
  <script src="https://cdn.jsdelivr.net/npm/vue@2.7.14/dist/vue.js"></script>
  
  <!-- 或生产版本,体积更小 -->
  <!-- <script src="https://cdn.jsdelivr.net/npm/vue@2.7.14/dist/vue.min.js"></script> -->
  
  <script>
    new Vue({
      el: '#app',
      data: {
        message: 'Hello Vue!'
      }
    })
  </script>
</body>
</html>

CDN 来源选择

CDN地址
jsDelivrhttps://cdn.jsdelivr.net/npm/vue@2.7.14/dist/vue.js
unpkghttps://unpkg.com/vue@2.7.14/dist/vue.js
cdnjshttps://cdnjs.cloudflare.com/ajax/libs/vue/2.7.14/vue.js

方式二:NPM 安装

适合现代前端项目,配合构建工具使用。

# 创建项目目录
mkdir my-vue-project
cd my-vue-project

# 初始化 package.json
npm init -y

# 安装 Vue
npm install vue@2.7.14

使用方式

// CommonJS
var Vue = require('vue')

// ES Module
import Vue from 'vue'

new Vue({
  el: '#app',
  data: {
    message: 'Hello Vue!'
  }
})

方式三:Vue CLI

Vue 官方提供的脚手架工具,适合创建完整的工程化项目。

安装 Vue CLI

# 全局安装
npm install -g @vue/cli

# 或使用 yarn
yarn global add @vue/cli

# 检查版本
vue --version

创建项目

# 创建新项目
vue create my-project

# 选择预设
? Please pick a preset:
  ❯ Default ([Vue 2] babel, eslint)
    Default (Vue 3) ([Vue 3] babel, eslint)
    Manually select features

手动选择特性

? Check the features needed for your project:
 ◉ Babel
 ◯ TypeScript
 ◯ Progressive Web App (PWA) Support
 ◉ Router
 ◉ Vuex
 ◯ CSS Pre-processors
 ◉ Linter / Formatter
 ◯ Unit Testing
 ◯ E2E Testing

项目结构

my-project/
├── node_modules/
├── public/
│   ├── favicon.ico
│   └── index.html
├── src/
│   ├── assets/
│   ├── components/
│   ├── router/
│   ├── store/
│   ├── views/
│   ├── App.vue
│   └── main.js
├── .gitignore
├── babel.config.js
├── package.json
└── vue.config.js

方式四:Vite

Vite 是新一代构建工具,开发体验更好。

# 创建项目
npm create vite@latest my-vue-project -- --template vue

# 进入项目
cd my-vue-project

# 安装依赖
npm install

# 启动开发服务器
npm run dev

Vue CLI vs Vite

特性Vue CLIVite
构建工具Webpackesbuild + Rollup
开发启动较慢极快
热更新较快极快
配置复杂度较高较低
生态成熟度成熟发展中

新项目推荐使用 Vite,现有项目可继续使用 Vue CLI。

开发工具推荐

编辑器

VS Code 是目前最流行的选择:

推荐插件:

插件用途
VeturVue 2 语法高亮、智能提示
Vue 3 Snippets代码片段
ESLint代码检查
Prettier代码格式化
Auto Close Tag自动闭合标签
Auto Rename Tag自动重命名标签

浏览器扩展

Vue DevTools 是必备的调试工具:

  1. Chrome 扩展商店搜索 "Vue.js devtools"
  2. Firefox 扩展商店搜索 "Vue.js devtools"
  3. 安装后在开发者工具中会出现 Vue 面板

功能包括:

  • 查看组件树
  • 检查组件状态
  • 追踪事件
  • 调试 Vuex
  • 分析性能

Node.js 版本

推荐使用 LTS 版本:

# 检查 Node 版本
node -v

# 推荐使用 nvm 管理 Node 版本
nvm install --lts
nvm use --lts

配置 ESLint

ESLint 可以帮助发现代码问题,保持代码风格一致。

安装

npm install -D eslint eslint-plugin-vue

配置文件

// .eslintrc.js
module.exports = {
  extends: [
    'plugin:vue/essential',
    'eslint:recommended'
  ],
  rules: {
    'no-console': process.env.NODE_ENV === 'production' ? 'warn' : 'off',
    'no-debugger': process.env.NODE_ENV === 'production' ? 'warn' : 'off'
  }
}

VS Code 集成

// .vscode/settings.json
{
  "editor.formatOnSave": true,
  "eslint.validate": [
    "javascript",
    "vue"
  ]
}

常见问题

1. 安装速度慢

使用国内镜像:

# 设置 npm 镜像
npm config set registry https://registry.npmmirror.com

# 或使用 cnpm
npm install -g cnpm --registry=https://registry.npmmirror.com

2. 权限问题

# macOS/Linux 修改 npm 全局目录
mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

3. 版本冲突

# 清除缓存
npm cache clean --force

# 删除 node_modules 重新安装
rm -rf node_modules package-lock.json
npm install

小结

方式适用场景
CDN学习、简单页面
NPM自定义构建配置
Vue CLI完整工程化项目
Vite新项目、追求开发体验

根据项目需求选择合适的方式。学习阶段推荐 CDN 或 Vite,正式项目推荐 Vite 或 Vue CLI。