如何为openapi-generator自动生成的文件添加顶部许可声明？

直接编辑openapi-generator/src/main/resources/go/partial_header.mustache并在顶部粘贴许可文本的方案可以实现预期效果，但并不是最优的实现方式，具体原因和更推荐的方案如下：

直接修改官方源码模板的弊端 #

• 后续升级openapi-generator版本时，你修改的源码文件会被官方新版本的文件覆盖，每次升级都需要重新修改，维护成本极高
• 硬编码的许可文本灵活性很差，如果后续需要调整许可内容、或者给不同项目生成带不同许可头的代码，每次都需要重新编辑模板文件，复用性低

更推荐的实现方案 #

方案1：使用自定义模板目录（无侵入式修改） #

把官方的partial_header.mustache模板复制到你本地项目单独存放的自定义模板目录中，在这个本地副本的顶部添加你的许可文本，执行代码生成命令时加上参数 -t <你本地自定义模板目录的路径>，即可覆盖官方默认模板，全程不需要修改官方源码，升级openapi-generator版本也不会影响你的自定义模板。

方案2：使用变量注入许可头（灵活性最高） #

你可以在partial_header.mustache模板中预留许可头的变量占位符，比如：

{{{licenseHeader}}}
// 原有模板内容

执行生成命令时通过附加参数传递许可内容：

openapi-generator generate -i <你的openapi描述文件路径> -g go --additional-properties licenseHeader="/* 你的许可文本内容 */"

如果许可内容较长，可以把许可内容存为单独的文本文件，通过命令读取文件内容传入参数即可，后续调整许可完全不需要修改模板，还可以给不同项目动态传入不同的许可头。

注意：Go 代码的许可头需要放在package声明的上方，不要放错位置导致代码编译失败。

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