Vue <template v-for> key should be placed on the <template> tag.

报错原因:

在使用 Vue 2 开发项目时,如果在 <template> 标签上使用 v-for 并添加 key 属性,可能会遇到如下错误提示:

<template v-for> key should be placed on the <template> tag.

这个错误通常出现在使用如 VsCode 或 WebStorm 等工具进行开发时,这些工具根据 Vue 3 的规则对 Vue 2 项目进行校验,导致报错。但实际上,‌Vue 2 中 key 应该放在 <template> 的子元素上 ‌,而不是 <template> 标签本身。

解决方案如下:
方法一:将 key 放在子元素上(推荐)

如果你的 <template> 中包含多个元素,应将 key 放在这些子元素上,例如:

复制代码
<template v-for="item in list" :key="item.id">
  <div>{{ item.name }}</div>
  <span>{{ item.value }}</span>
</template>
方法二:将 <template> 替换为 <div> 并添加 key

如果不想改动结构,也可以将 <template> 替换为 <div>,并添加 key

复制代码
<div v-for="item in list" :key="item.id">
  <div>{{ item.name }}</div>
  <span>{{ item.value }}</span>
</div>
方法三:使用 v-if="true" 绕过 ESLint 检查

在 Vue 2 中,可以为 key 所在的组件或标签添加 v-if="true",来规避 ESLint 的检测:

复制代码
<template v-for="item in list" :key="item.id" v-if="true">
  <div>{{ item.name }}</div>
</template>
方法四:配置 ESLint 忽略该规则(适用于项目全局)

在项目根目录添加或修改 .eslintrc.jsjsconfig.json 文件,以忽略该规则:

复制代码
{
  "eslint.validate": [
    "javascript",
    "javascriptreact",
    "vue"
  ]
}
总结
  • Vue 2 中,key 应该放在 <template> 的子元素上;
  • 若使用 Vue 3 规则校验工具(如 Volar),需注意区分 Vue 2 和 Vue 3 的语法差异;
  • 可通过替换标签、添加 v-if、修改 ESLint 配置等方式解决该问题。
相关推荐
初一初十10 小时前
vue3实现的纯前端护肤品商城网站
前端·javascript·vue.js·前端框架
卷帘依旧10 小时前
React状态管理方案怎么选
前端
zeqinjie10 小时前
Flutter 折叠屏 iPad / 宽屏适配实践
android·前端·flutter
小村儿10 小时前
连载13- 内部Tools,Claude Code 怎么真正"动"你的代码
前端·后端·ai编程
IT_陈寒10 小时前
Python的线程池把我坑惨了,原来异步不是万能的
前端·人工智能·后端
ANnianStriver11 小时前
PetLumina 07 — 宠物管理升级与 JavaScript 大数精度修复
开发语言·javascript·ai编程·宠物
初一初十11 小时前
vue3茶叶商城网站vue网页vuejs前端
前端·javascript·vue.js·vscode·前端框架
kyriewen11 小时前
前端性能优化:LCP 从 4s 到 0.9s 的 5 个核心手段(附配置代码)
前端·javascript·性能优化
xiaofeichaichai11 小时前
Proxy与Reflect
前端·javascript
小蜜蜂dry12 小时前
nestjs实战-权限二:角色模块
前端·后端·nestjs