From 566202ce47d3979db9ab2ae37f6327bc1b836649 Mon Sep 17 00:00:00 2001
From: ZhouXY108 <luquanlion@outlook.com>
Date: Thu, 8 Aug 2024 14:55:42 +0800
Subject: [PATCH] =?UTF-8?q?=E6=B7=BB=E5=8A=A0=E6=B3=A8=E9=87=8A=E8=AF=B4?=
 =?UTF-8?q?=E6=98=8E=E3=80=82?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java | 3 ++-
 1 file changed, 2 insertions(+), 1 deletion(-)

diff --git a/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java b/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java
index 6c781fd..684fb21 100644
--- a/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java
+++ b/src/main/java/xyz/zhouxy/plusone/commons/util/TreeBuilder.java
@@ -54,13 +54,14 @@ public class TreeBuilder<T, TSubTree extends T, TIdentity> {
     /**
      * 将节点构建成树。
      * <p>
-     * <b>注意，该方法会直接操作 nodes 列表中的节点，并没有做深拷贝，
+     * <b>！！注意：该方法会直接操作 nodes 列表中的节点，并没有做深拷贝，
      * 注意避免 nodes 中的元素产生变化所带来的意料之外的影响。</b>
      * 
      * @param nodes      平铺的节点列表
      * @param comparator 用于节点的排序。
      *                   若为 {@code null}，则使用 {@link #defaultComparator}；
      *                   若 {@link #defaultComparator} 也为 {@code null}，则不排序。
+     *                   <b>仅影响调用 addChild 的顺序，如果操作对象本身对应的控制了子节点的顺序，无法影响其相关逻辑。</b>
      */
     public List<T> buildTree(Collection<T> nodes, @Nullable Comparator<? super T> comparator) {
         Preconditions.checkNotNull(nodes);