Vue3项目初始化时配置ESLint的核心是先用CLI引导初始化,再按需整合TS和Vue支持;推荐用create-vue脚手架并勾选ESLint选项,或对已有Vite项目执行pnpx eslint --init,准确选择Vue、TS、Browser/Node等选项,确保extends包含plugin:vue/vue3-essential、plugin:@typescript-eslint/recommended和plugin:prettier/recommended。

Vue 3 项目初始化时配置 ESLint 校验规则,核心是「先初始化 ESLint,再按需整合 TypeScript 和 Vue 支持」,避免后期手动补全依赖或冲突。推荐用官方 CLI 引导方式,一步生成适配 Vue3 + TS + Vite 的基础校验能力。
用 create-vue 或 vite 初始化后立即配 ESLint
现代 Vue 官方脚手架(create-vue)已内置 ESLint 选项,推荐优先使用:
- 运行
npm create vue@latest或pnpm create vue - 在交互式提问中,明确选择 “Add ESLint for code quality”
- 后续会自动询问是否启用 TypeScript、Vue Router、Pinia 等 —— ESLint 配置会根据你选的 TS 选项自动引入
@typescript-eslint相关插件 - 完成后,项目自带
eslint.config.js(或eslint.config.ts),并预设了plugin:vue/vue3-essential和plugin:@typescript-eslint/recommended
若已用 vite 创建项目,手动初始化 ESLint
对已有 vite + vue3 + ts 项目,执行标准 ESLint 初始化流程即可,关键点在于准确回答向导问题:
- 运行
pnpx eslint --init(推荐 pnpm;npm/yarn 同理) -
What do you want to lint? → 选
JavaScript(它实际也覆盖 .ts/.vue) -
How would you like to use ESLint? → 选
To check syntax, find problems, and enforce code style -
What type of modules does your project use? → 选
JavaScript modules (import/export) -
Which framework does your project use? → 选
Vu e.js -
Does your project use TypeScript? → 选
Yes -
Where does your code run? → 空格勾选
Browser和Node -
What format do you want your config file to be in? → 推荐
TypeScript(需 Node ≥24.3.0;否则选 JavaScript 并安装 jiti) - 最后确认安装依赖,工具会自动添加
eslint-plugin-vue、@typescript-eslint/eslint-plugin等必要包
配置文件里必须包含的关键扩展
生成的配置文件(如 eslint.config.ts)需确保 extends 包含以下三类规则集:
立即学习“前端免费学习笔记(深入)”;
-
plugin:vue/vue3-essential:Vue3 基础语法与最佳实践(如v-if/v-for顺序、组件命名) -
plugin:@typescript-eslint/recommended:TypeScript 类型安全相关检查(如禁止any、强制接口定义) -
plugin:prettier/recommended(搭配eslint-config-prettier):关闭所有与 Prettier 冲突的格式化规则,让 Prettier 专管格式
加一条实用脚本快速验证
在 package.json 的 scripts 中加入:
"lint": "eslint . --ext .js,.ts,.vue --fix",
运行 npm run lint 即可扫描全部源码并自动修复可修问题。首次运行可能报错,常见原因是 parserOptions.project 未指向 tsconfig.json,此时在配置中补充:
parserOptions: { project: "./tsconfig.json" }


















