Java通用Bean拷贝工具的核心在于属性映射逻辑：需处理private字段访问（setAccessible）、过滤static/final/synthetic/transient字段；支持基础类型与包装类自动转换、字符串解析数字/日期；递归拷贝嵌套对象与集合时用IdentityHashMap防循环引用；支持字段排除、命名策略转换及注解控制。
Java反射实现通用Bean拷贝工具，核心不在“反射有多难”，而在于理清属性映射的边界与逻辑——哪些字段该拷贝、类型不匹配怎么处理、嵌套对象如何递归、集合和数组如何兼容、访问权限怎么绕过。掌握这些，才能写出真正健壮、可复用的拷贝工具。
精准识别可拷贝属性：不只是public字段
反射默认只能访问public成员，但实际业务中目标字段常为private。需主动调用setAccessible(true)打破封装限制。同时要过滤掉静态（static）、final、合成（synthetic）字段，避免误操作：
- 遍历
Class.getDeclaredFields()而非getFields()，确保覆盖所有声明字段 - 对每个字段检查
Modifier.isStatic(field.getModifiers())和field.isSynthetic() - 跳过
transient字段（除非明确要求序列化级拷贝）
安全类型转换与赋值：拒绝硬编码强转
源字段和目标字段类型可能不完全一致（如Long ←→ long、String ←→ Integer、LocalDateTime ←→ String），不能简单用Object.class.cast()。应构建轻量类型适配器：
- 基础类型与包装类之间自动解/装箱（如int ↔ Integer）
- 字符串到数字、日期等提供默认解析逻辑（如使用
NumberUtils.createLong()或DateTimeFormatter） - 类型不可转换时记录warn日志，跳过该字段而非抛异常（提升容错性）
递归处理嵌套对象与集合：避免无限循环
遇到属性是自定义对象或List/Set/Map时，需递归调用拷贝逻辑；但必须防止循环引用导致栈溢出：
当用户要求为 Java 代码添加注释、修改注释、审查注释、整理注释格式，或要求按照代码注释规范处理 Java 文件时，使用本技能。本技能用于统一生成和维护 Java 类注释模板、按 Git 对比 release 判断版本号、补充每行代码上方中文块注释、调整注释空行规则，并保持 Java 文件 UTF-8 无 BOM 编码。典型触发场景包括：补充类注释、更新 @version、检查 @author 来源、整理行尾注释、把注释放到代码上一行、检查注释是否符合规范、构建前检查 Java 注释风格。
立即学习“Java免费学习笔记（深入）”；
- 维护一个
IdentityHashMap<object object></object>缓存已拷贝对象的原始引用 → 新实例映射 - 每次拷贝前先查缓存，命中则直接返回对应新实例
- 对List等集合，先创建空目标集合（如
new ArrayList()），再逐项拷贝元素并add
支持命名策略与字段排除：贴近真实业务场景
实际中常需忽略某些字段（如id、createTime），或按驼峰/下划线规则匹配不同命名风格的源目标类：
- 提供
excludeFields参数接受字段名数组，拷贝前校验跳过 - 内置
FieldNameConverter接口，支持SnakeCaseToCamelCase等策略，让user_name自动匹配userName - 允许通过注解（如
@CopyIgnore、@CopyAs("realName")）控制单字段行为
不复杂但容易忽略——真正决定工具是否能落地的，从来不是反射调用那几行代码，而是对属性语义、类型边界、引用关系的细致处理。
