Hutool中常用的工具类&真实项目的黄金组合

Hutool 就像 Java 世界里的一把瑞士军刀 🧰

不用啰嗦配置，不搞复杂套路，拿来即用。下面我带你用一条"上手路线"，从 0 到能在项目里自然挥舞它。

一、引入Hutool

<dependency>
    <groupId>cn.hutool</groupId>
    <artifactId>hutool-all</artifactId>
    <version>5.8.25</version>
</dependency>

二、最常用的 8 大工具类（项目必备）

1️⃣ 字符串工具：StrUtil

StrUtil.isBlank(str);
StrUtil.isNotEmpty(str);
StrUtil.equals("a", "A", true); // 忽略大小写
StrUtil.format("用户{}登录成功", userName);

✔️ 替代 StringUtils

---

2️⃣ 时间工具：DateUtil

DateTime now = DateUtil.date();
String time = DateUtil.now();

Date date = DateUtil.parse("2026-01-10");
DateTime offset = DateUtil.offsetDay(date, 3);

---

3️⃣ JSON 工具：JSONUtil

String json = JSONUtil.toJsonStr(obj);
User user = JSONUtil.toBean(json, User.class);
List<User> list = JSONUtil.toList(jsonArray, User.class);

---

4️⃣ 集合工具：CollUtil

CollUtil.isEmpty(list);
CollUtil.newArrayList(1, 2, 3);
CollUtil.union(list1, list2);

---

5️⃣ 数组工具：ArrayUtil

ArrayUtil.isEmpty(arr);
ArrayUtil.join(arr, ",");

---

6️⃣ 对象工具：ObjectUtil

ObjectUtil.isNull(obj);
ObjectUtil.isNotNull(obj);
ObjectUtil.equal(a, b);

---

7️⃣ Bean 工具：BeanUtil（对象拷贝神器）

UserVO vo = BeanUtil.copyProperties(entity, UserVO.class);

进阶：

BeanUtil.copyProperties(dto, entity,
        CopyOptions.create().ignoreNullValue());

---

8️⃣ 校验工具：Validator

Validator.isEmail("test@qq.com");
Validator.isMobile("13800138000");

---

三、真实项目里的"黄金组合" 🏆

Controller 层

@PostMapping("/add")
public Result add(@RequestBody UserDTO dto) {

    if (ObjectUtil.isNull(dto)) {
        return Result.fail("参数为空");
    }

    User entity = BeanUtil.copyProperties(dto, User.class);
    userService.save(entity);

    return Result.success();
}

---

返回给前端

UserVO vo = BeanUtil.copyProperties(entity, UserVO.class);
return Result.success(vo);

---

日志 / 调试

log.info("请求参数：{}", JSONUtil.toJsonStr(dto));

---