JHipster Blueprint生成器支持的JHipster版本与降级方法

支持的JHipster版本范围 #

• 目前独立发布的generator-jhipster-blueprint脚手架最新稳定版本，仅完整兼容JHipster 6.x全系列版本，从JHipster 7.0.0开始的所有大版本都不做官方支持。
• JHipster 7.x对blueprint的底层加载逻辑做了破坏性更新：包括命名空间强制全小写规则、生成器上下文API重构、模板路径解析逻辑重写，你遇到的命名空间解析报错、jhContext.setupServerOptions is not a function报错，都是版本不兼容导致的典型问题，和历史issue中反馈的故障现象完全匹配。
• 从JHipster 7.x版本开始，主仓库已经内置了blueprint开发所需的基础能力，不需要再单独安装旧版的blueprint生成器脚手架，旧脚手架不会再做7.x及以上版本的适配。

JHipster 降级到兼容版本的具体操作 #

推荐降级到6.x系列的最终稳定版6.10.5，操作步骤如下：

1. 卸载全局环境中已安装的高版本JHipster

npm uninstall -g generator-jhipster

2. 全局安装指定的兼容版本

npm install -g generator-jhipster@6.10.5

3. 进入你的blueprint项目目录，清理原有依赖并重装匹配版本

# 删除现有依赖和锁文件
rm -rf node_modules package-lock.json yarn.lock
# 手动修改package.json中generator-jhipster依赖的版本号为6.10.5
# 重新安装依赖
npm install

4. 版本校验

jhipster --version

命令行输出版本号为6.10.5后，再执行blueprint相关的生成、调试命令即可。

额外排错提示：你的blueprint名称TestQuestion包含大写字母，不符合JHipster的命名规则——blueprint包名generator-jhipster-xxx中的xxx部分必须全小写，就算版本降级完成，也需要把名称改成全小写格式（比如testquestion）才能被正常识别加载。

内容的提问来源于stack exchange，提问作者Hervé Labrie-Durand