Vue / 系统课时

配置编辑器与开发插件

配置编辑器与开发插件

这一节把 VS Code 配成适合 Vue 3 + TypeScript 团队协作的最小开发环境:Vue 单文件组件有正确类型提示,保存时按统一格式整理代码,并优先使用项目自己的 TypeScript 版本,减少“我这里不报错”的环境差异。

学习目标

  • 安装 Vue Official 与 Prettier,并知道何时需要 ESLint 扩展。
  • 用工作区配置统一格式化器和 TypeScript SDK。
  • 通过类型诊断与命令行检查验证编辑器配置确实生效。

安装最小扩展

如果本机已启用 VS Code 的 code 命令,可以直接安装团队需要的核心扩展:

bash
code --install-extension Vue.volar
code --install-extension esbenp.prettier-vscode

预期结果

text
两个命令均以退出码 0 完成;扩展处于已安装状态。

再用扩展 ID 验证,不依赖界面名称:

bash
code --list-extensions | grep -E '^(Vue\.volar|esbenp\.prettier-vscode)$'

预期输出

text
Vue.volar
esbenp.prettier-vscode

如果系统没有 code 命令,也可以在 VS Code 的 Extensions 面板按扩展 ID 搜索并安装。Vue Official 负责 .vue 文件中的模板、脚本、组件属性和 TypeScript 类型能力;Prettier 负责一致的代码格式。若项目已经配置 ESLint,再额外安装 dbaeumer.vscode-eslint,不要只装编辑器扩展却缺少项目内 ESLint 配置。

固定工作区设置

团队配置应进入项目的 .vscode/settings.json,而不是只依赖每个人的全局偏好。下面的配置让 VS Code 优先使用项目 node_modules 中的 TypeScript,并让 Vue 与 TypeScript 文件统一由 Prettier 格式化。

json
{
  "typescript.tsdk": "node_modules/typescript/lib",
  "typescript.enablePromptUseWorkspaceTsdk": true,
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "esbenp.prettier-vscode",
  "[vue]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  },
  "[typescript]": {
    "editor.defaultFormatter": "esbenp.prettier-vscode"
  }
}

这是配置文件,不会产生固定控制台输出。保存后重新打开工作区;当 VS Code 提示使用 Workspace TypeScript 时选择项目版本。这样成员即使安装了不同的全局 TypeScript,也会尽量围绕仓库声明的版本获得一致类型行为。

验证类型提示

把 src/App.vue 临时改成下面这个完整组件,用一个明确的类型错误检查 Vue Official 是否真正接管了单文件组件。

vue
<script setup lang="ts">
const message: string = 42
</script>

<template>
  <h1>{{ message }}</h1>
</template>

预期结果

text
编辑器在 message 的赋值处显示 TypeScript 类型错误;把 42 改为字符串后诊断消失。

如果 .ts 文件有提示而 .vue 文件完全没有提示,优先检查 Vue Official 是否被禁用、Vetur 是否同时生效,以及当前工作区是否被 VS Code 设为受限模式。

验证项目级类型检查

编辑器提示用于即时反馈,但最终仍要用仓库里的工具做一次命令行校验。在 Vite 创建的 Vue TypeScript 项目根目录运行:

bash
npx vue-tsc --noEmit

预期结果

text
无错误时不输出诊断信息,命令以退出码 0 结束。

如果这里报错而编辑器没有提示,先确认 .vscode/settings.json 的 typescript.tsdk 路径存在,再执行 VS Code 的 Reload Window 并重启 Vue Language Server。反过来,若编辑器报错而 vue-tsc 通过,则检查扩展缓存、项目是否打开了正确根目录,以及 Workspace TypeScript 是否已经切换。把“保存格式一致”和“编辑器诊断与 vue-tsc 基本一致”作为环境配置完成的验收标准。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

配置编辑器与开发插件

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通