CodeGeex实战：自动生成阿里开发手册Java代码

项目冲刺阶段，交付时间紧迫、规范要求严苛——必须严格遵循《阿里巴巴Java开发手册》：Controller层需符合RESTful风格，Service层强制使用构造器注入，集合初始化必须指定容量。逐条翻阅手册耗时费力，有没有更高效的替代方案？

CodeGeex插件能够智能解析手册规范，在编码过程中实时生成合规代码，甚至主动检测潜在违规。下面展示的每一步操作均经过验证，可直接应用于实际开发流程。

安装并激活CodeGeex插件（集成Alibaba Java Coding Guidelines）

在VS Code扩展市场中搜索“CodeGeex”，点击安装后重启编辑器。接着点击右下角状态栏的CodeGeex图标，切换至「Java」语言模型，待右上角显示「Ready」状态即表示就绪。

一个常见陷阱：若状态栏未出现CodeGeex图标，说明插件初始化未完成。务必关闭所有Java文件标签页后再重启VS Code，否则模型加载不完整，后续生成的代码将忽略手册约束条件。亲身踩坑后的经验总结。

编写符合手册规范的Controller层代码

新建空白Java文件，在顶部写入注释指令：// @alibaba: controller, restful, static method forbidden。将光标移至注释后的空行，按下Ctrl+Enter（Windows/Linux）或Cmd+Enter（macOS），CodeGeex即开始代码补全。

自动生成的代码会自动包含@RestController注解，返回类型使用String而非void，方法名采用小驼峰命名，路径变量通过@PathVariable显式标注——这两处直接规避了手册中的两条高危红线：禁止void返回类型、方法名必须遵循lowerCamelCase。

利用CodeGeex对现有代码进行合规校验

方法一：选中已编写的Java代码段，右键选择「CodeGeex: Analyze with Alibaba Guidelines」。弹窗将列出所有违反手册的条目，例如“集合初始化未指定容量”“日志变量缺少final修饰”。

方法二：在代码顶部添加特殊注释指令：// @alibaba: check: collection-init, logger-final，随后触发补全。CodeGeex自动生成修复建议代码块并覆盖原位置。注意，分析结果中的“推荐替换为new ArrayList<>(8)”这类提示并非泛泛建议——它严格依据手册第3.4.2条“集合初始化时应指定初始容量”生成，有据可查。

生成Service层代码并强制注入方式合规

第一步：在类上方写入注释：// @alibaba: service, constructor-injection, forbid field-injection。

第二步：输入类声明框架：public class UserService {，然后按下Ctrl+Enter。

第三步：CodeGeex不会生成常见的@Autowired private XxxMapper mapper;字段注入写法，而是直接生成带final修饰符的构造函数参数，并在构造函数体内完成赋值。这完全吻合手册“推荐使用构造器注入，禁止setter或字段注入”的要求。

第四步：若删除了构造函数中的某一行赋值语句，再次触发补全时，CodeGeex会立即恢复该行。它强制要求final字段必须完成初始化，严谨程度远超人工校验。