Vue 3 项目初始化怎么配置 TypeScript 严格模式

阿萱吖_6979

阿萱吖_6979

2026-10-22

391人浏览

原创

启用 "strict": true 是开启 typescript 严格模式最核心方式,需同时配置 skiplibcheck、moduleresolution、baseurl/paths、include 和 types,并在 env.d.ts 中声明 .vue 类型。

vue 3 项目初始化怎么配置 typescript 严格模式

直接在 tsconfig.json 的 compilerOptions 中启用 "strict": true 即可,这是开启 TypeScript 严格模式最核心、最有效的方式。它会一并激活一系列子检查项(如 noImplicitAny、strictNullChecks、strictFunctionTypes 等),大幅提升类型安全性。

关键配置项必须补全

仅开 strict 不够,还需确保以下几项明确存在且合理:

  • "skipLibCheck": true:跳过对 node_modules 中类型声明的检查,大幅提升编译速度,是实际项目中的通用做法;
  • "moduleResolution": "node":确保模块解析行为与 Node.js 一致,避免 import 路径报错;
  • "baseUrl": "." 和 "paths":配合 Vite 的别名(如 @/ 指向 src/),让 TypeScript 也能识别路径别名,否则 VS Code 会提示“无法找到模块”;
  • "include" 必须包含 .vue 文件:例如 "src/**/*.vue",否则组件中的类型不会被检查;
  • 添加 "types": ["node", "vite/client"]:显式引入 Node 和 Vite 的全局类型,避免 process、import.meta.env 等报错。

Vue 特有类型支持不能少

在 src/env.d.ts 中必须有标准声明,否则 .vue 文件无法被正确推导类型:

vue-composition-api-best-practices
vue-composition-api-best-practices

Vue 3 组合式 API 与

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Vue 教程
Vue 教程

共42课时 | 17.2万人学习

国外Web开发全栈课程全集
国外Web开发全栈课程全集

共12课时 | 1.4万人学习

Vue.js 微实战--十天技能课堂
Vue.js 微实战--十天技能课堂

共18课时 | 1.7万人学习