Vue / 系统课时
配置编辑器与开发插件
配置编辑器与开发插件
这一节把 VS Code 配成适合 Vue 3 + TypeScript 团队协作的最小开发环境:Vue 单文件组件有正确类型提示,保存时按统一格式整理代码,并优先使用项目自己的 TypeScript 版本,减少“我这里不报错”的环境差异。
学习目标
- 安装 Vue Official 与 Prettier,并知道何时需要 ESLint 扩展。
- 用工作区配置统一格式化器和 TypeScript SDK。
- 通过类型诊断与命令行检查验证编辑器配置确实生效。
安装最小扩展
如果本机已启用 VS Code 的 code 命令,可以直接安装团队需要的核心扩展:
code --install-extension Vue.volar
code --install-extension esbenp.prettier-vscode预期结果
两个命令均以退出码 0 完成;扩展处于已安装状态。再用扩展 ID 验证,不依赖界面名称:
code --list-extensions | grep -E '^(Vue\.volar|esbenp\.prettier-vscode)$'预期输出
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 格式化。
{
"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 是否真正接管了单文件组件。
<script setup lang="ts">
const message: string = 42
</script>
<template>
<h1>{{ message }}</h1>
</template>预期结果
编辑器在 message 的赋值处显示 TypeScript 类型错误;把 42 改为字符串后诊断消失。如果 .ts 文件有提示而 .vue 文件完全没有提示,优先检查 Vue Official 是否被禁用、Vetur 是否同时生效,以及当前工作区是否被 VS Code 设为受限模式。
验证项目级类型检查
编辑器提示用于即时反馈,但最终仍要用仓库里的工具做一次命令行校验。在 Vite 创建的 Vue TypeScript 项目根目录运行:
npx vue-tsc --noEmit预期结果
无错误时不输出诊断信息,命令以退出码 0 结束。如果这里报错而编辑器没有提示,先确认 .vscode/settings.json 的 typescript.tsdk 路径存在,再执行 VS Code 的 Reload Window 并重启 Vue Language Server。反过来,若编辑器报错而 vue-tsc 通过,则检查扩展缓存、项目是否打开了正确根目录,以及 Workspace TypeScript 是否已经切换。把“保存格式一致”和“编辑器诊断与 vue-tsc 基本一致”作为环境配置完成的验收标准。