Superset自定义插件Yeoman报错，咨询环境问题、指南时效性及替代方案

报错原因 #

你遇到的Current environment doesn't provides some necessary feature this generator needs报错，核心是跳过了指南开头的yarn环境准备步骤。Superset前端生态完全基于yarn管理依赖，Yeoman生成器需要依赖yarn提供的包管理环境，缺失这些前置依赖就会触发环境检测失败。

官方指南是否过时？ #

当前Apache Superset的插件开发指南并未过时，但必须严格遵循所有前置步骤——跳过yarn初始化属于操作遗漏，并非指南失效。

正确的插件初始化步骤 #

补全环境准备后再执行Yeoman初始化，步骤如下：

• 安装匹配版本的Node.js（Superset 2.x推荐v16，3.x推荐v18），然后全局安装yarn：

  npm install -g yarn
  

• 进入Superset项目的superset-frontend目录，执行依赖安装：

  yarn install
  

• 全局安装Yeoman和Superset插件生成器：

  yarn global add yo @superset-ui/generator-superset
  

• 最后运行生成器初始化插件：

  yo @superset-ui/superset
  

更优的自定义图表创建方式 #

除了Yeoman生成器，还有两种更灵活的方式：

1. 直接使用官方插件模板 #

无需依赖Yeoman，直接基于官方维护的插件模板修改：

• 克隆插件模板仓库，进入目录后执行yarn install安装依赖
• 修改package.json中的插件名称、描述等配置信息
• 在src目录下编写图表的渲染逻辑、配置面板等代码
• 执行yarn build打包插件，将产物集成到Superset的插件目录中

2. 直接在Superset源码中新增图表 #

适合不需要将图表做成独立插件的场景：

• 进入superset-frontend/src/visualizations目录，新建专属文件夹，仿照现有图表的结构编写组件、配置文件和控制器
• 修改visualizations/presets/MainPreset.js，在注册列表中添加新图表的配置
• 执行yarn build重新构建前端，重启Superset服务后即可在仪表盘选择新图表

额外注意事项 #

• 务必保证Node.js版本与Superset版本兼容，版本不兼容会导致各类环境依赖报错
• 如果仍有问题，可删除superset-frontend下的node_modules和yarn.lock文件，重新执行yarn install清理缓存后再尝试

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