通义灵码生成StringUtils与DateUtils工具类封装指南
日常 Java 开发中，工具类的编写总是重复且琐碎——判空、格式化、脱敏……每换一个项目就得重写一套，稍不留神还会遗漏线程安全或 null 校验。通义灵码的出现简化了这件事：只需用自然语言描述需求，它就能自动生成符合工程规范的封装类，连 Javadoc 和依赖适配都一并完成。下面通过几个典型场景，展示具体落地方式。
用自然语言指令生成 StringUtils 封装类
在 IDE 中新建一个 Java 文件，命名为 StringUtilsExt.java，将光标放在类声明上方的空白处，直接编写注释：
// 封装常用字符串工具方法：判空（trim 后）、去首尾空格、非空校验、安全截取、安全拼接、HTML 转义、手机号脱敏
然后按下 Alt + P（Windows）或 Option + P（Mac），通义灵码会基于当前项目依赖（例如已引入 commons-lang3 或 Hutool）自动生成完整的类。生成的代码底层调用 org.apache.commons.lang3.StringUtils，其中的 isBlank() 和 trim() 均具备 null 安全保护，不会抛出 NPE。如果项目未引入这些第三方库，它会自动降级到 JDK 原生方法，并显式添加 null 判断逻辑。
生成后，建议检查第 7 行左右的手机号脱敏方法——默认按「1[3-9]\d{9}」这个正则匹配。但如果项目中手机号格式包含国际区号或分机号，则需要手动调整正则表达式，否则脱敏会直接失效。这个细节极易被忽略，务必提前注意。
让通义灵码生成线程安全的 DateUtils 封装
新建 DateUtilsExt.java，在类名下方写一行自然语言提示：
// 基于 java.time API 封装日期工具：LocalDateTime ↔ String 格式化/解析（支持 yyyy-MM-dd HH:mm:ss 和 yyyy-MM-dd）、获取当天起止时间、计算两个 LocalDateTime 的分钟差、加减天数、获取本周一日期
同样触发 Alt + P，这次通义灵码会跳过已废弃的 SimpleDateFormat，全部改用 DateTimeFormatter.ofPattern(...).withLocale(Locale.CHINA) 构建 formatter 实例，且每个 formatter 被声明为 private static final 字段——这是保证线程安全的关键，切勿改为局部变量或在方法内 new 一个，否则多线程环境下容易出问题。
重点关注生成的 parseLocalDateTime(String str, String pattern) 方法：它对传入的 str 做了非空与长度校验，但不会校验 pattern 的合法性。如果 pattern 字符串拼写错误（比如写成 "yyyy-MM-DD"），运行时会抛出 DateTimeParseException。该异常需要在调用方兜底捕获。
批量生成多个工具类并统一包路径与注释
第一步：在项目根目录下新建 package com.example.util，确保与主模块的 groupId 一致；
第二步：在该包内新建一个空文件 AppUtils.java，将光标定位到文件顶部；
第三步：输入多行自然语言指令：
// 生成一个聚合工具类 AppUtils，内部静态嵌套 StringUtils、DateUtils、JsonUtils 三个子类
// 每个子类提供至少 5 个高频方法，方法命名遵循 Spring 风格（如 hasText、now、toJson）
// 所有方法必须有 Javadoc，说明参数含义、返回值、异常场景
// JsonUtils 依赖 Hutool 的 JSONUtil，若未引入则用 Jackson 替代并添加 try-catch
第四步：按下 Alt + P 等待生成完成；
第五步：逐个点击生成的三个 static class 名称，按 Ctrl + Shift + R（IntelliJ）重命名提取为独立的顶层类，然后移动到同一个包下——这一步必须手动操作，通义灵码目前不会自动拆分嵌套类，需要手动收尾。