什么是Vue​？

Vue (发音为 /vjuː/，类似view) 是一款用于构建用户界面的 JavaScript 框架。它基于标准 HTML、CSS 和 JavaScript 构建，并提供了一套声明式的、组件化的编程模型，帮助你高效地开发用户界面。无论是简单还是复杂的界面，Vue 都可以胜任。

下面是一个最基本的示例：​

​js

import { createApp } from 'vue'​createApp({data() {return {count: 0}}}).mount('#app')​template
结果展示
Count is: 0
上面的示例展示了 Vue 的两个核心功能：
  • 声明式渲染：Vue 基于标准 HTML 拓展了一套模板语法，使得我们可以声明式地描述最终输出的 HTML 和 JavaScript 状态之间的关系。
  • 响应性：Vue 会自动跟踪 JavaScript 状态并在其发生变化时响应式地更新 DOM。
你可能已经有了些疑问——先别急，在后续的文档中我们会详细介绍每一个细节。现在，请继续看下去，以确保你对 Vue 作为一个框架到底提供了什么有一个宏观的了解。
预备知识
文档接下来的内容会假设你对 HTML、CSS 和 JavaScript 已经基本熟悉。如果你对前端开发完全陌生，最好不要直接从一个框架开始进行入门学习——最好是掌握了基础知识再回到这里。你可以通过这篇JavaScript 概述来检验你的 JavaScript 知识水平。如果之前有其他框架的经验会很有帮助，但也不是必须的。
渐进式框架
Vue 是一个框架，也是一个生态。其功能覆盖了大部分前端开发常见的需求。但 Web 世界是十分多样化的，不同的开发者在 Web 上构建的东西可能在形式和规模上会有很大的不同。考虑到这一点，Vue 的设计非常注重灵活性和“可以被逐步集成”这个特点。根据你的需求场景，你可以用不同的方式使用 Vue：
  • 无需构建步骤，渐进式增强静态的 HTML
  • 在任何页面中作为 Web Components 嵌入
  • 单页应用 (SPA)
  • 全栈 / 服务端渲染 (SSR)
  • Jamstack / 静态站点生成 (SSG)
  • 开发桌面端、移动端、WebGL，甚至是命令行终端中的界面
如果你是初学者，可能会觉得这些概念有些复杂。别担心！理解教程和指南的内容只需要具备基础的 HTML 和 JavaScript 知识。即使你不是这些方面的专家，也能够跟得上。
如果你是有经验的开发者，希望了解如何以最合适的方式在项目中引入 Vue，或者是对上述的这些概念感到好奇，我们在使用 Vue 的多种方式中讨论了有关它们的更多细节。
无论再怎么灵活，Vue 的核心知识在所有这些用例中都是通用的。即使你现在只是一个初学者，随着你的不断成长，到未来有能力实现更复杂的项目时，这一路上获得的知识依然会适用。如果你已经是一个老手，你可以根据实际场景来选择使用 Vue 的最佳方式，在各种场景下都可以保持同样的开发效率。这就是为什么我们将 Vue 称为“渐进式框架”：它是一个可以与你共同成长、适应你不同需求的框架。
单文件组件
在大多数启用了构建工具的 Vue 项目中，我们可以使用一种类似 HTML 格式的文件来书写 Vue 组件，它被称为单文件组件(也被称为*.vue文件，英文 Single-File Components，缩写为SFC)。顾名思义，Vue 的单文件组件会将一个组件的逻辑 (JavaScript)，模板 (HTML) 和样式 (CSS) 封装在同一个文件里。下面我们将用单文件组件的格式重写上面的计数器示例：
vue
export default { data() { return { count: 0 } }}​ ​button { font-weight: bold;}
单文件组件是 Vue 的标志性功能。如果你的用例需要进行构建，我们推荐用它来编写 Vue 组件。你可以在后续相关章节里了解更多关于单文件组件的用法及用途。但你暂时只需要知道 Vue 会帮忙处理所有这些构建工具的配置就好。
API 风格
Vue 的组件可以按两种不同的风格书写：选项式 API和组合式 API。
选项式 API (Options API)
使用选项式 API，我们可以用包含多个选项的对象来描述组件的逻辑，例如data、methods和mounted。选项所定义的属性都会暴露在函数内部的this上，它会指向当前的组件实例。
vue
export default { // data() 返回的属性将会成为响应式的状态 // 并且暴露在 `this` 上 data() { return { count: 0 } },​ // methods 是一些用来更改状态与触发更新的函数 // 它们可以在模板中作为事件监听器绑定 methods: { increment() { this.count++ } },​ // 生命周期钩子会在组件生命周期的各个不同阶段被调用 // 例如这个函数就会在组件挂载完成后被调用 mounted() { console.log(`The initial count is ${this.count}.`) }}​ 
组合式 API (Composition API)
通过组合式 API，我们可以使用导入的 API 函数来描述组件逻辑。在单文件组件中，组合式 API 通常会与”>搭配使用。这个setupattribute 是一个标识，告诉 Vue 需要在编译时进行一些处理，让我们可以更简洁地使用组合式 API。比如，中的导入和顶层变量/函数都能够在模板中直接使用。
下面是使用了组合式 API 与改造后和上面的模板完全一样的组件：
vue
import { ref, onMounted } from 'vue'​// 响应式状态const count = ref(0)​// 用来修改状态、触发更新的函数function increment() {count.value++}​// 生命周期钩子onMounted(() => {console.log(`The initial count is ${count.value}.`)})​​​
该选哪一个？
两种 API 风格都能够覆盖大部分的应用场景。它们只是同一个底层系统所提供的两套不同的接口。实际上，选项式 API 是在组合式 API 的基础上实现的！关于 Vue 的基础概念和知识在它们之间都是通用的。
选项式 API 以“组件实例”的概念为中心 (即上述例子中的this)，对于有面向对象语言背景的用户来说，这通常与基于类的心智模型更为一致。同时，它将响应性相关的细节抽象出来，并强制按照选项来组织代码，从而对初学者而言更为友好。
组合式 API 的核心思想是直接在函数作用域内定义响应式状态变量，并将从多个函数中得到的状态组合起来处理复杂问题。这种形式更加自由，也需要你对 Vue 的响应式系统有更深的理解才能高效使用。相应的，它的灵活性也使得组织和重用逻辑的模式变得更加强大。
在组合式 API FAQ章节中，你可以了解更多关于这两种 API 风格的对比以及组合式 API 所带来的潜在收益。
如果你是使用 Vue 的新手，这里是我们的大致建议：
  • 在学习的过程中，推荐采用更易于自己理解的风格。再强调一下，大部分的核心概念在这两种风格之间都是通用的。熟悉了一种风格以后，你也能够很快地理解另一种风格。
  • 在生产项目中：
    • 当你不需要使用构建工具，或者打算主要在低复杂度的场景中使用 Vue，例如渐进增强的应用场景，推荐采用选项式 API。
    • 当你打算用 Vue 构建完整的单页应用，推荐采用组合式 API + 单文件组件。
在学习阶段，你不必只固守一种风格。在接下来的文档中我们会为你提供一系列两种风格的代码供你参考，你可以随时通过左上角的API 风格偏好来做切换。
线上尝试 Vue
  • 想要快速体验 Vue，你可以直接试试我们的演练场。
  • 如果你更喜欢不用任何构建的原始 HTML，可以使用JSFiddle入门。
  • 如果你已经比较熟悉 Node.js 和构建工具等概念，还可以直接在浏览器中打开StackBlitz来尝试完整的构建设置。
创建一个 Vue 应用
前提条件
  • 熟悉命令行
  • 已安装 16.0 或更高版本的Node.js
在本节中，我们将介绍如何在本地搭建 Vue单页应用。创建的项目将使用基于Vite的构建设置，并允许我们使用 Vue 的单文件组件(SFC)。
确保你安装了最新版本的Node.js，然后在命令行中运行以下命令 (不要带上>符号)：
> npm init vue@latest
这一指令将会安装并执行create-vue，它是 Vue 官方的项目脚手架工具。你将会看到一些诸如 TypeScript 和测试支持之类的可选功能提示：
✔ Project name: … ✔ Add TypeScript? … No / Yes✔ Add JSX Support? … No / Yes✔ Add Vue Router for Single Page Application development? … No / Yes✔ Add Pinia for state management? … No / Yes✔ Add Vitest for Unit testing? … No / Yes✔ Add Cypress for both Unit and End-to-End testing? … No / Yes✔ Add ESLint for code quality? … No / Yes✔ Add Prettier for code formatting? … No / Yes​Scaffolding project in ./...Done.
如果不确定是否要开启某个功能，你可以直接按下回车键选择No。在项目被创建后，通过以下步骤安装依赖并启动开发服务器：
> cd > npm install> npm run dev
你现在应该已经运行起来了你的第一个 Vue 项目！请注意，生成的项目中的示例组件使用的是组合式 API和，而非选项式 API。下面是一些补充提示：
  • 推荐的 IDE 配置是Visual Studio Code+Volar 扩展。如果使用其他编辑器，参考IDE 支持章节。
  • 更多工具细节，包括与后端框架的整合，我们会在工具链指南进行讨论。
  • 要了解构建工具 Vite 更多背后的细节，请查看Vite 文档。
  • 如果你选择使用 TypeScript，请阅读TypeScript 使用指南。
当你准备将应用发布到生产环境时，请运行：
> npm run build
此命令会在./dist文件夹中为你的应用创建一个生产环境的构建版本。关于将应用上线生产环境的更多内容，请阅读生产环境部署指南。
“>下一步>
通过 CDN 使用 Vue
你可以借助 script 标签直接通过 CDN 来使用 Vue：
html
这里我们使用了unpkg，但你也可以使用任何提供 npm 包服务的 CDN，例如jsdelivr或cdnjs。当然，你也可以下载此文件并自行提供服务。
通过 CDN 使用 Vue 时，不涉及“构建步骤”。这使得设置更加简单，并且可以用于增强静态的 HTML 或与后端框架集成。但是，你将无法使用单文件组件 (SFC) 语法。
使用全局构建版本
上面的例子使用了全局构建版本的 Vue，该版本的所有顶层 API 都以属性的形式暴露在了全局的Vue对象上。这里有一个使用全局构建版本的例子：
html
​{{ message }}​ const { createApp } = Vue  createApp({ data() { return { message: 'Hello Vue!' } } }).mount('#app')
使用 ES 模块构建版本
在本文档的其余部分我们使用的主要是ES 模块语法。现代浏览器大多都已原生支持 ES 模块。因此我们可以像这样通过 CDN 以及原生 ES 模块使用 Vue：
html
{{ message }}​ import { createApp } from 'https://unpkg.com/vue@3/dist/vue.esm-browser.js'  createApp({ data() { return { message: 'Hello Vue!' } } }).mount('#app')
注意我们使用了，且导入的 CDN URL 指向的是 Vue 的ES 模块构建版本。
启用 Import maps
在上面的示例中，我们使用了完整的 CDN URL 来导入，但在文档的其余部分中，你将看到如下代码：
js
import { createApp } from 'vue'
我们可以使用导入映射表 (Import Maps)来告诉浏览器如何定位到导入的vue：
html
 { "imports": { "vue": "https://unpkg.com/vue@3/dist/vue.esm-browser.js" } }​{{ message }}​ import { createApp } from 'vue'​ createApp({ data() { return { message: 'Hello Vue!' } } }).mount('#app')
你也可以在映射表中添加其他的依赖——但请务必确保你使用的是该库的 ES 模块版本。
导入映射表的浏览器支持情况
目前只有基于 Chromium 的浏览器支持导入映射表，所以我们推荐你在学习过程中使用 Chrome 或 Edge。
如果你使用的是 Firefox 浏览器，则该功能仅在 102+ 版本中受支持，且目前需要启用about:config中的dom.importMaps.enabled选项。
如果你更喜欢那些还不支持导入映射表的浏览器，你可以使用es-module-shims来进行 polyfill。
生产环境中的注意事项
到目前为止示例中使用的都是 Vue 的开发构建版本——如果你打算在生产中通过 CDN 使用 Vue，请务必查看生产环境部署指南。
拆分模块
随着对这份指南的逐步深入，我们可能需要将代码分割成单独的 JavaScript 文件，以便更容易管理。例如：
htmlimport { createApp } from 'vue'import MyComponent from './my-component.js'​createApp(MyComponent).mount('#app')​js// my-component.jsexport default {data() {return { count: 0 }},template: `count is {{ count }}`}
如果直接在浏览器中打开了上面的index.html，你会发现它抛出了一个错误，因为 ES 模块不能通过file://协议工作。为了使其工作，你需要使用本地 HTTP 服务器通过http://协议提供index.html。
要启动一个本地的 HTTP 服务器，请先安装Node.js，然后从命令行在 HTML 文件所在文件夹下运行npx serve。你也可以使用其他任何可以基于正确的 MIME 类型服务静态文件的 HTTP 服务器。
可能你也注意到了，这里导入的组件模板是内联的 JavaScript 字符串。如果你正在使用 VSCode，你可以安装es6-string-html扩展，然后在字符串前加上一个前缀注释/*html*/以高亮语法。
无需构建的组合式 API 用法
组合式 API 的许多示例将使用语法。如果你想在无需构建的情况下使用组合式 API，请参阅setup()选项。