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