如何解决Grafana面板插件开发中jsdoc PluginConflictError报错

解决方案 #

• 停止eslint向上读取父级配置
  在项目根目录的.eslintrc/.eslintrc.js配置顶层添加root: true；如果eslint配置写在package.json的eslintConfig字段中，同样在该字段下添加"root": true。该配置会限制eslint仅加载当前项目的配置规则，不会读取上层目录的.eslintrc，避免两份@grafana/eslint-config重复加载导致jsdoc插件冲突。
• 跳过lint环节直接构建
  若开发阶段不需要强制校验代码规范，修改package.json的开发命令，添加跳过lint参数即可：

  "scripts": {
    "dev": "grafana-toolkit plugin:dev --skip-lint"
  }
  

  重新执行yarn dev即可正常启动构建。
• 统一依赖版本解决冲突
  1. 移除所有@grafana/开头依赖版本号前的^标识符，固定为你使用的精确版本（如7.4.3或对应8.x的具体版本），避免小版本自动升级带来的兼容问题。
  2. 强制统一eslint-plugin-jsdoc版本：
     若使用yarn，在package.json添加resolutions字段：

  "resolutions": {
    "eslint-plugin-jsdoc": "^37.0.0"
  }
  

  若使用npm，在package.json添加overrides字段：

  "overrides": {
    "eslint-plugin-jsdoc": "^37.0.0"
  }
  

  配置完成后删除node_modules、yarn.lock/package-lock.json文件，重新执行依赖安装即可。

内容的提问来源于stack exchange，提问作者computerman