字段别名需将@XStreamAlias加在getter方法上并显式调用processAnnotations()，如getUserName()标@XStreamAlias("name")使userName序列化为；不可加在字段或setter上，且必须启用注解支持。
Java 中 XStream 给字段起别名，用 @XStreamAlias 注解是最直接的方式，但它**不能直接加在字段上**——必须加在**类定义或 getter/setter 方法上**（取决于配置），且需配合 XStream.processAnnotations() 或启用注解支持。
@XStreamAlias 用在类上（全局类名映射）
这个注解最常用在类级别，用于指定该类序列化后的 XML 根元素名称，不是字段别名：
@XStreamAlias("user")
public class User {
private String userName;
private int age;
}此时
@XStreamAlias 用在 getter 方法上（推荐：字段别名生效）
要让某个字段在 XML 中显示为自定义名称（比如 userName → name），需把 @XStreamAlias 加在对应的 **getter 方法** 上，并确保 XStream 启用了注解支持：
立即学习“Java免费学习笔记（深入）”；
- 启用注解：调用
xstream.processAnnotations(User.class) - 注解位置：必须放在 getter（如
getUserName()），不是字段或 setter - 字段本身保持默认访问（private 可以，无需 public）
public class User {
private String userName;
private int age;
@XStreamAlias("name")
public String getUserName() {
return userName;
}
public void setUserName(String userName) {
this.userName = userName;
}
@XStreamAlias("user-age")
public int getAge() {
return age;
}
public void setAge(int age) {
this.age = age;
}
}序列化结果示例：
替代方案：使用 @XStreamAsAttribute 或 @XStreamConverter
如果还想进一步控制格式，比如让字段变成属性而非子节点，可组合使用：
-
@XStreamAsAttribute：让 getter 返回值作为 XML 属性（需配合@XStreamAlias） -
@XStreamConverter：自定义字段序列化逻辑（如日期格式、枚举转字符串）
例如：
@XStreamAlias("id")
@XStreamAsAttribute
public String getId() { ... }生成：
注意事项和常见坑
以下情况会导致 @XStreamAlias 不生效：
- 忘记调用
xstream.processAnnotations(YourClass.class)—— 默认不扫描注解 - 注解放在字段或 setter 上 —— XStream 忽略（除非用反射模式 + 特殊配置，不推荐）
- 使用了
xstream.autodetectAnnotations(true)但未调用processAnnotations—— 仍可能不生效，建议显式调用 - 类路径下有多个同名类或混淆导致类加载异常 —— 检查日志中是否报 “No such field” 类错误
基本上就这些。核心就一条：字段别名靠 getter 上的 @XStreamAlias + 显式处理注解，简单但容易忽略配置步骤。
