Collections.rotate()用于旋转List元素，正数位移向右旋转，负数向左旋转，需传入非空列表。
在Java中，Collections.rotate() 是一个静态方法，用于将集合中的元素向右或向左“旋转”指定的位数。这个方法属于 java.util.Collections 工具类，适用于任何实现了 List 接口的集合（如 ArrayList、LinkedList 等）。
如何使用 Collections.rotate() 旋转集合
rotate 方法的基本语法如下：
public static void rotate(List> list, int distance)其中：
- list：要旋转的列表，不能为空，否则会抛出 NullPointerException。
- distance：旋转的位移量。
旋转规则如下：
立即学习“Java免费学习笔记（深入）”；
- 若 distance > 0，元素向右移动（末尾元素移到前面）。
- 若 distance ，元素向左移动（前面元素移到后面）。
- 若 distance == 0 或集合大小为 0 或 1，集合不变。
- 位移会自动对集合大小取模，避免无效计算。
示例代码：
ListSystem.out.println("原始列表: " + list);
Collections.rotate(list, 2);
System.out.println("向右旋转2位: " + list); // 输出: [D, E, A, B, C]
Collections.rotate(list, -3);
System.out.println("向左旋转3位: " + list); // 输出: [A, B, C, D, E]
集合旋转的实际应用场景
虽然旋转操作看似简单，但在一些实际场景中非常有用：
1. 轮播图或任务调度顺序调整
在实现轮播机制时，比如每日值班人员轮换，可以通过 rotate 将当前值班人推到末尾，其他人前移一位，实现公平调度。
将后端 Java 接口文档转换为前端 TypeScript 类型定义（interface / type）。输入：飞书文档、Spring Boot 接口文档、Swagger/OpenAPI、手写 API 文档等。输出：包含请求参数与响应结果的 .md 文件，含完整 JSDoc 注释。触发关键词：Java 转 TS、接口转换、生成前端类型、接口文档转 TypeScript、DTO/VO/BO 转 interface、后端文档转前端类型、生成接口类型、类型定义生成。
2. 数据加密或编码变换
字符序列的简单位移加密（类似凯撒密码）中，可以使用 rotate 实现字符位置的整体偏移。
3. 游戏角色顺序切换
回合制游戏中，玩家行动顺序可能需要循环切换。rotate 可以快速将当前玩家移到队尾，保持顺序流转。
4. 缓存或队列的动态重排序
某些缓存策略需要将最近使用的元素提前或延后，结合 rotate 可实现批量位置调整。
注意事项与性能提示
使用 rotate 时需注意以下几点：
- 只能用于 List，Set、Map 不支持（无序或不保证顺序）。
- 底层通过数组复制实现，时间复杂度为 O(n)，适合中小规模集合。
- 原集合会被直接修改，如需保留原数据，应先复制一份。
- 空集合调用会抛出异常，建议提前判空。
基本上就这些。Collections.rotate 是一个简洁高效的工具方法，合理使用可以在特定业务逻辑中简化代码，提升可读性。关键是理解位移方向和模运算的影响，避免误操作。
