参加你附近的 ,了解 VS Code 中的 AI 辅助开发。

在 Visual Studio Code 中使用 Vue

Vue.js 是一个流行的 JavaScript 库,用于构建 Web 应用程序和用户界面。Visual Studio Code 内置了对 Vue.js 构建块 HTMLCSSJavaScript 的支持。为了获得更丰富的 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 --versionnpm --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 语言功能(语法高亮、智能感知和格式化)。

Vue - Official extension

在通知中,按安装下载并安装 Vue 扩展。您应该会在扩展视图中看到 Vue 扩展正在安装。安装完成后(可能需要几分钟),安装按钮会变为管理齿轮按钮。

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

Vue language features

IntelliSense

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

Vue.js suggestions

以及 scripts 部分中的 Vue 属性,如 computed

Vue.js JavaScript suggestions

转到定义,速览定义

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

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

要使用“速览定义”,请按照以下步骤操作

  1. 将光标放在 App 上。
  2. 右键单击,将鼠标悬停在上下文菜单中的速览上,然后选择速览定义
  3. 一个速览窗口将打开,显示来自 App.jsApp 定义。

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/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 的特定语法错误,这些错误在编辑器中显示为红色波浪线,并显示在问题面板中(查看 > 问题 ⇧⌘M (Windows、Linux Ctrl+Shift+M))。

下面您可以看到当 Vue linter 在模板中检测到多个根元素时出现的错误

Vue linting

调试

您可以使用内置的 JavaScript 调试器调试客户端 Vue.js 代码。请参考这篇讨论,了解如何在 VS Code 中结合 Microsoft Edge 使用 Vite/Vue.js 3 项目。

对于 Vue CLI(目前处于维护模式),请查看 VS Code 调试秘籍网站上的在 VS Code 中调试 Vue.js秘籍以了解更多信息。

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

其他扩展

  • 在扩展视图(⇧⌘X (Windows、Linux Ctrl+Shift+X))中输入 vue 进行搜索,以查找其他 Vue 扩展。

    Vue.js extensions

  • Vue VS Code Snippets 这样的扩展可以方便地提供 Vue 代码片段。

    Vue VS Code Snippets

  • 还有一些扩展包,它们捆绑了其他人认为对 Vue.js 开发有用的扩展。

    Vue.js Extension Pack