解决 error Component name “index“ should always be multi-word vue/multi-word-component-names

倔强的小绵羊

已于 2022-06-19 01:36:43 修改

阅读量5.4w

点赞数 29

文章标签： Eslint

于 2022-06-16 14:08:48 首次发布

本文链接：https://blog.csdn.net/lhz_333/article/details/125313088

版权

本文介绍了当使用最新vue-cli创建项目并运行时遇到vue/multi-word-component-names错误的原因及解决办法。报错原因是eslint-plugin-vue更新了规则，要求组件名必须使用驼峰命名。解决方案包括两种：一是遵循新规则，将组件如index.vue改为驼峰命名，二是修改.eslintrc.js配置文件，关闭或忽略该命名规则。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

前言

本文主要记录下 vue Eslint 报错 error Component name "index" should always be multi-word vue/multi-word-component-names 的解决方案。

一、报错原因

使用最新 vue-cli 创建项目，npm run serve 运行项目时，报错如下图。

原因是 eslint-plugin-vue 版本更新了，相较之前版本，@8 版本中新增了不少规则，第一条就是 'vue/multi-word-component-names': 'error', 要求组件名称以驼峰格式命名，所以 index.vue 会报错。

二、解决方案

按照规则，使用驼峰命名，例如 AppHeader.vue
在 .eslintrc.js 文件中关闭命名规则

// .eslintrc.js
module.exports = {
  root: true,
  env: {
    node: true,
  },
  extends: [
    "plugin:vue/vue3-essential",
    "eslint:recommended",
    "@vue/typescript/recommended",
    "plugin:prettier/recommended",
  ],
  parserOptions: {
    ecmaVersion: 2020,
  },
  rules: {
    "vue/multi-word-component-names": [
      "error",
      {
        ignores: ["index"], //需要忽略的组件名
      },
    ],
  },
};