在 Visual Studio Code 中使用 Vue

Name: Visual Studio Code
Author: Microsoft

Vue.js 是一个流行的 JavaScript 库，用于构建 Web 应用程序和用户界面。Visual Studio Code 对 Vue.js 的基础构建块（即 HTML、CSS 和 JavaScript）提供了内置支持。为了获得更丰富的 Vue.js 开发环境，您可以安装 Vue - Official (原名 Volar) 扩展，以获得对 IntelliSense（智能感知）、TypeScript、代码格式化等功能的支持。

注意：Vue 2 的支持已于 2023 年 12 月 31 日结束，因此不建议继续使用 Vetur 扩展。您需要禁用 Vetur 才能使用 Vue - Official 扩展。

welcome to Vue

欢迎来到 Vue

在本教程中，我们将使用 Vite 工具链。如果您是 Vue.js 框架的新手，可以在 vuejs.org 网站上找到很棒的文档和教程。

要安装和使用 Vite 和 Vue.js，您需要安装 Node.js JavaScript 运行时环境和 npm（Node.js 包管理器）。npm 已包含在 Node.js 中，您可以从 Node.js 下载页面安装它。

提示：要测试您的计算机上是否正确安装了 Node.js 和 npm，可以输入 node --version 和 npm --version 进行检查。

首先，请确保您位于打算创建项目的父目录下。然后打开终端或命令提示符并输入

npm create vue@latest

系统将提示您安装 create-vue。

Create vue

安装并执行 create-vue 可能需要几分钟时间，它将帮助您搭建 Vue 项目的基础结构。请按照提示选择可选功能。如果不确定某个选项，可以选择“否 (No)”。

Vue app scaffolding

项目创建完成后，进入项目目录并安装依赖项。安装依赖项可能需要几分钟。

cd <your-project-name>
npm install

让我们通过输入 npm run dev 快速运行我们的 Vue 应用程序，启动 Web 服务器并在浏览器中打开该应用程序。

npm run dev

您应该可以在浏览器中的 https://:5173 看到“Welcome to your Vue.js App”。

要在 VS Code 中打开您的 Vue 应用程序，请从终端（或命令提示符）进入 vue-project 文件夹，然后输入 code .

cd vue-project
code .

VS Code 将启动并在文件资源管理器中显示您的 Vue 应用程序。

Vue - Official 扩展

现在展开 src 文件夹并选择 App.vue 文件。您会注意到 VS Code 没有显示任何语法高亮，并且如右下角状态栏所示，它将该文件视为纯文本。您还会看到一条通知，建议为 .vue 文件类型安装 Vue - Official 扩展。

Vue 扩展为 VS Code 提供了 Vue.js 语言功能（语法高亮、IntelliSense 和代码格式化）。

Vue - Official extension

点击通知中的安装 (Install) 按钮下载并安装 Vue 扩展。您应该会在“扩展”视图中看到 Vue 扩展显示为正在安装 (Installing)。安装完成后（可能需要几分钟），安装按钮将变为管理 (Manage) 齿轮按钮。

现在，您应该可以看到 .vue 已被识别为 Vue.js 语言文件类型，并且拥有语法高亮、括号匹配和悬停说明等语言功能。

Vue language features

IntelliSense

当您开始在 App.vue 中输入代码时，不仅会看到针对 HTML 和 CSS 的智能建议或补全，还会看到针对 Vue.js 特定项的建议，例如 Vue template 部分中的声明 (v-bind, v-for)

Vue.js suggestions

以及 scripts 部分中如 computed 等 Vue 属性的建议。

Vue.js JavaScript suggestions

转到定义，速览定义

VS Code 中的 Vue - Official 扩展通过提供类型定义等语言服务功能，增强了 Vue.js 的开发体验。您可以通过以下方式访问这些功能：

转到定义 (Go to Definition) (F12)：直接跳转到代码中的类型定义。
速览定义 (Peek Definition) (⌥F12 (Windows Alt+F12, Linux Ctrl+Shift+F10))：在不离开当前上下文的情况下内联查看类型定义。

要使用“速览定义”功能，请执行以下步骤：

将光标放在 App 上。
右键单击，将鼠标悬停在上下文菜单的速览 (Peek) 上，然后选择速览定义 (Peek Definition)。
一个速览窗口将会打开，显示来自 App.js 的 App 定义。

Vue.js peek definition

按 Escape 关闭速览窗口。

Hello World

让我们更新示例应用程序以渲染“Hello World!”。在 App.vue 中，将 HelloWorld 组件 msg 自定义属性文本替换为“Hello World!”。

<template>
  <header>
    <img alt="Vue logo" class="logo" src="/assets/docs/nodejs/assets/logo.svg" width="125" height="125" />

    <div class="wrapper">
      <HelloWorld msg="Hello World!" />
    </div>
  </header>

  <main>
    <TheWelcome />
  </main>
</template>

保存 App.vue 文件后 (⌘S (Windows, Linux Ctrl+S))，Vite 的热模块替换 (HMR) 功能将立即在浏览器中反映更新，您将看到“Hello World!”。保持服务器运行，接下来我们将学习 Vue.js 客户端调试。

提示：VS Code 支持自动保存，默认情况下它会在延迟后保存你的文件。在文件菜单中勾选自动保存选项以开启该功能，或者直接配置 files.autoSave 用户设置。

hello world

代码检查

Linter（代码检查工具）会分析您的源代码，并在您运行应用程序之前警告您潜在的问题。Vue ESLint 插件 (eslint-plugin-vue) 会检查 Vue.js 特有的语法错误，这些错误会在编辑器中显示为红色波浪线，并显示在问题 (Problems) 面板中（查看 (View) > 问题 (Problems) ⇧⌘M (Windows, Linux Ctrl+Shift+M)）。

如下所示，当 Vue linter 检测到模板中有多个根元素时，会出现错误

Vue linting

调试

您可以使用内置的 JavaScript 调试器调试客户端 Vue.js 代码。请参阅此对话，了解如何通过 Microsoft Edge 在 VS Code 中使用 Vite/Vue.js 3 项目。

对于已进入维护模式的 Vue CLI，请查看 VS Code 调试方案 (recipes) 网站上的 VS Code 中的 Vue.js 调试方案以了解更多信息。

另一个流行的 Vue.js 调试工具是 vue-devtools 插件，它可以在任何环境下使用。

其他扩展

在“扩展”视图 (⇧⌘X (Windows, Linux Ctrl+Shift+X)) 中输入 vue，可以搜索并找到其他 Vue 扩展。
像 Vue VS Code Snippets 这样的扩展对于获取 Vue 代码片段非常方便。
此外还有扩展包 (Extension Packs)，它们捆绑了其他人认为对 Vue.js 开发有用的扩展。

5/28/2026