diff --git a/hutool-core/src/main/java/cn/hutool/core/io/FileUtil.java b/hutool-core/src/main/java/cn/hutool/core/io/FileUtil.java
index 4c838288d..4f234e9b4 100644
--- a/hutool-core/src/main/java/cn/hutool/core/io/FileUtil.java
+++ b/hutool-core/src/main/java/cn/hutool/core/io/FileUtil.java
@@ -223,9 +223,11 @@ public class FileUtil extends PathUtil {
}
/**
- * 递归遍历目录以及子目录中的所有文件
+ * 递归遍历目录以及子目录中的所有文件
+ * 如果用户传入相对路径,则是相对classpath的路径
+ * 如:"test/aaa"表示"${classpath}/test/aaa"
*
- * @param path 当前遍历文件或目录的路径
+ * @param path 相对ClassPath的目录或者绝对路径目录
* @return 文件列表
* @since 3.2.0
*/
@@ -245,7 +247,9 @@ public class FileUtil extends PathUtil {
/**
* 获得指定目录下所有文件
- * 不会扫描子目录
+ * 不会扫描子目录
+ * 如果用户传入相对路径,则是相对classpath的路径
+ * 如:"test/aaa"表示"${classpath}/test/aaa"
*
* @param path 相对ClassPath的目录或者绝对路径目录
* @return 文件路径列表(如果是jar中的文件,则给定类似.jar!/xxx/xxx的路径)
@@ -287,7 +291,7 @@ public class FileUtil extends PathUtil {
/**
* 创建File对象,相当于调用new File(),不做任何处理
*
- * @param path 文件路径
+ * @param path 文件路径,相对路径表示相对项目路径
* @return File
* @since 4.1.4
*/
@@ -298,7 +302,7 @@ public class FileUtil extends PathUtil {
/**
* 创建File对象,自动识别相对或绝对路径,相对路径将自动从ClassPath下寻找
*
- * @param path 文件路径
+ * @param path 相对ClassPath的目录或者绝对路径目录
* @return File
*/
public static File file(String path) {
diff --git a/hutool-core/src/test/java/cn/hutool/core/io/FileUtilTest.java b/hutool-core/src/test/java/cn/hutool/core/io/FileUtilTest.java
index 4b513abeb..2d04528ba 100644
--- a/hutool-core/src/test/java/cn/hutool/core/io/FileUtilTest.java
+++ b/hutool-core/src/test/java/cn/hutool/core/io/FileUtilTest.java
@@ -298,6 +298,12 @@ public class FileUtilTest {
}
}
+ @Test
+ @Ignore
+ public void loopFilesTest2() {
+ FileUtil.loopFiles("").forEach(Console::log);
+ }
+
@Test
@Ignore
public void loopFilesWithDepthTest() {