Vue.js安装与环境搭建

Vue.js提供了多种安装方式,从最简单的CDN引入到使用现代化的构建工具。本章将详细介绍各种安装方法,并指导你搭建完整的Vue.js开发环境。

前提条件

在开始安装Vue.js之前,请确保你已具备以下条件:

基本的HTML、CSS和JavaScript知识
熟悉命令行/终端操作
已安装文本编辑器(如VS Code、Sublime Text等)
对于使用构建工具的方式,需要安装Node.js和npm

安装方法概览

根据你的需求和项目类型,可以选择以下安装方式:

CDN引入

最简单快捷的方式,适合学习、原型开发或简单的页面增强。

  • 无需构建工具
  • 快速开始
  • 不适合大型项目
推荐初学者

npm安装

使用npm或yarn安装,适合与现代构建工具(如Webpack)配合使用。

  • 适合构建流程
  • 便于管理依赖
  • 需要Node.js环境
推荐实际项目

Vue CLI

官方脚手架工具,提供完整的项目结构和构建配置。

  • 标准化项目结构
  • 丰富的插件系统
  • 配置相对复杂
推荐企业项目

Vite + Vue

新一代前端构建工具,提供极快的开发服务器启动和热更新。

  • 启动速度快
  • 现代化构建工具
  • 生态相对较新
Vue 3推荐

方法一:CDN引入(最简单)

1

创建HTML文件

创建一个新的HTML文件,例如 index.html

2

添加Vue.js CDN链接

<head>标签中添加Vue.js的CDN链接:

使用最新版本(推荐)

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>我的第一个Vue应用</title>
    <!-- 开发环境版本,包含了有帮助的命令行警告 -->
    <script src="https://cdn.jsdelivr.net/npm/vue@2/dist/vue.js"></script>
    <!-- 生产环境版本,优化了尺寸和速度 -->
    <!-- <script src="https://cdn.jsdelivr.net/npm/vue@2"></script> -->
</head>
<body>
    <div id="app">
        {{ message }}
    </div>

    <script>
        var app = new Vue({
            el: '#app',
            data: {
                message: 'Hello Vue!'
            }
        });
    </script>
</body>
</html>
                            
Vue 3 CDN引入方式

<!DOCTYPE html>
<html lang="zh-CN">
<head>
    <meta charset="UTF-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0">
    <title>Vue 3示例</title>
    <script src="https://unpkg.com/vue@next"></script>
</head>
<body>
    <div id="app">
        {{ message }}
    </div>

    <script>
        const app = Vue.createApp({
            data() {
                return {
                    message: 'Hello Vue 3!'
                }
            }
        });

        app.mount('#app');
    </script>
</body>
</html>
                            
3

在浏览器中打开文件

直接在浏览器中打开HTML文件,即可看到Vue应用运行效果。

可用CDN源

除了jsDelivr,还可以使用以下CDN:

  • unpkg: https://unpkg.com/vue@2/dist/vue.js
  • cdnjs: https://cdnjs.cloudflare.com/ajax/libs/vue/2.6.14/vue.js
  • BootCDN: https://cdn.bootcdn.net/ajax/libs/vue/2.6.14/vue.min.js

方法二:npm安装(推荐实际项目)

1

安装Node.js和npm

访问 Node.js官网 下载并安装Node.js(建议选择LTS版本)。安装完成后,验证安装:

$ node --version
$ npm --version
2

创建项目目录并初始化

创建一个新的项目目录,并初始化npm项目:

$ mkdir my-vue-project
$ cd my-vue-project
$ npm init -y

这会生成一个package.json文件,记录项目信息和依赖。

3

安装Vue.js

使用npm安装Vue.js:

# 安装Vue 2(稳定版)
$ npm install vue@2

# 安装Vue 3(最新版)
$ npm install vue@next
4

安装构建工具(Webpack)

Vue.js需要配合构建工具使用。安装webpack和webpack-cli:

$ npm install webpack webpack-cli --save-dev
$ npm install vue-loader vue-template-compiler --save-dev

还需要配置webpack,创建webpack.config.js文件。这是使用Vue CLI或Vite更简单的原因。

方法三:Vue CLI(官方脚手架)

Vue CLI是Vue.js官方的标准工具,提供完整的项目脚手架、构建配置和插件系统。

1

全局安装Vue CLI

使用npm全局安装Vue CLI:

$ npm install -g @vue/cli
# 或者使用yarn
$ yarn global add @vue/cli
2

验证安装

检查Vue CLI版本,确保安装成功:

$ vue --version
@vue/cli 4.5.13
3

创建新项目

使用Vue CLI创建新项目:

$ vue create my-vue-app

创建过程中会提示选择预设配置:

  • Default (Vue 2): 默认配置,包含babel和eslint
  • Default (Vue 3): Vue 3的默认配置
  • Manually select features: 手动选择功能(推荐)
4

启动开发服务器

进入项目目录并启动开发服务器:

$ cd my-vue-app
$ npm run serve

启动成功后,在浏览器中打开 http://localhost:8080 查看应用。

Vue CLI创建的项目结构

my-vue-app/
├── node_modules/     # 项目依赖
├── public/           # 静态资源
│   ├── index.html    # 入口HTML文件
│   └── favicon.ico   # 网站图标
├── src/              # 源代码目录
│   ├── assets/       # 资源文件(图片、样式等)
│   ├── components/   # Vue组件
│   ├── App.vue       # 根组件
│   └── main.js       # 入口JS文件
├── .gitignore        # Git忽略配置
├── babel.config.js   # Babel配置
├── package.json      # 项目配置和依赖
├── README.md         # 项目说明
└── vue.config.js     # Vue CLI配置(可选)
                        

方法四:Vite + Vue(现代化构建)

Vite是新一代前端构建工具,由Vue作者尤雨溪开发,提供极快的开发服务器启动和热更新。Vue 3官方推荐使用Vite。

1

使用Vite创建Vue项目

使用npm创建Vite项目:

# 使用npm 6.x
$ npm init @vitejs/app my-vue-app --template vue

# 使用npm 7+(需要额外的--)
$ npm init @vitejs/app my-vue-app -- --template vue

# 使用yarn
$ yarn create @vitejs/app my-vue-app --template vue

创建完成后,选择Vue模板,然后选择Vue或Vue+TypeScript。

2

安装依赖并启动

进入项目目录,安装依赖并启动开发服务器:

$ cd my-vue-app
$ npm install
$ npm run dev

启动成功后,在浏览器中打开 http://localhost:3000 查看应用。

注意:Vite和Vue CLI的区别

Vite在开发模式下使用原生ES模块导入,不需要打包,因此启动速度极快。而Vue CLI使用Webpack,需要在开发前打包所有模块。

安装方法对比

方法 优点 缺点 适用场景
CDN引入
  • 简单快速
  • 无需构建工具
  • 适合学习
  • 无构建流程
  • 不适合大型项目
  • 依赖网络
学习、原型开发、简单页面增强
npm安装
  • 适合构建流程
  • 便于管理依赖
  • 版本控制方便
  • 需要配置构建工具
  • 需要Node.js环境
  • 学习曲线较陡
实际项目、需要构建流程
Vue CLI
  • 标准化项目结构
  • 丰富的插件系统
  • 完善的构建配置
  • 相对较重
  • 启动速度较慢
  • 配置复杂
企业级应用、大型项目
Vite + Vue
  • 启动速度极快
  • 现代化构建工具
  • Vue 3官方推荐
  • 生态相对较新
  • 插件较少
  • 生产构建需要优化
新项目、追求开发体验、Vue 3项目

开发工具与扩展

以下工具可以极大提升Vue.js开发效率:

Vue Devtools

浏览器扩展,用于调试Vue.js应用,可以查看组件层次、状态和事件。

安装扩展
VS Code + Vetur

VS Code是最流行的代码编辑器,Vetur扩展提供Vue语法高亮、代码补全等功能。

安装扩展
Git版本控制

使用Git管理代码版本,建议配合GitHub、GitLab或Gitee使用。

下载Git
Node.js版本管理

使用nvm(Mac/Linux)或nvm-windows(Windows)管理多个Node.js版本。

查看nvm

常见问题与解决

可以尝试以下方法:

  1. 使用淘宝镜像:npm config set registry https://registry.npmmirror.com
  2. 使用yarn替代npm:npm install -g yarn
  3. 使用cnpm:npm install -g cnpm --registry=https://registry.npmmirror.com
  4. 清理npm缓存:npm cache clean --force

根据项目需求选择:

  • 选择Vue 2:需要稳定、成熟的生态系统;现有Vue 2项目维护;团队熟悉Vue 2
  • 选择Vue 3:新项目开始;需要更好的性能;想使用Composition API;需要TypeScript更好支持

Vue 3是未来的方向,但Vue 2仍然会长期维护。

可能是网络问题或npm源问题:

  1. 检查网络连接
  2. 使用淘宝镜像:npm config set registry https://registry.npmmirror.com
  3. 使用vue create --skip-plugins my-app跳过插件安装
  4. 使用vue create -d my-app使用默认配置快速创建

验证安装成功

无论使用哪种安装方法,当你在浏览器中看到"Hello Vue!"或Vue的欢迎页面,并且可以修改代码并实时看到变化时,说明Vue.js已成功安装并运行。

下一步:创建第一个Vue应用

环境搭建完成后,接下来我们将学习Vue.js的基本语法和核心概念,创建第一个完整的Vue.js应用。