7hutool实战:FileUtil 文件工具类(100多个文件常用操作方法)_hutool fileutil

技术活，该赏
关注+一键三连（点赞，评论，收藏）再看，养成好习惯
1
2

hutool实战（带你掌握里面的各种工具）目录

用途：文件工具类(文件常用操作)

使用场景

提供100多个文件常用操作方法，包含并不局限于：判断文件或文件夹是否为空、判断file是否为文件或文件夹、递归文件夹里的所有文件、获取指定文件夹的所有文件名、获取临时文件夹或临时文件的内容或者路径、计算文件夹或文件的总大小、创建文件或文件夹、创建临时文件或临时文件夹、删除文件或文件夹、修改文件名或文件夹名、复制文件或文件夹、移动文件或文件夹、清空文件夹、获取规范的绝对路径、比较两个文件、判断文件是否被改动、获取父路径或子路径、获取主文件名或后缀名等

项目引用

此博文的依据：hutool-5.6.5版本源码

        <dependency>
			<groupId>cn.hutool</groupId>
			<artifactId>hutool-core</artifactId>
			<version>5.6.5</version>
		</dependency>
1
2
3
4
5

方法摘要

 1、src和dest都为目录，则将src目录及其目录下所有文件目录拷贝到dest下 2、src和dest都为文件，直接复制，名字为dest 3、src为文件，dest为目录，将src拷贝到dest目录下 

 1、src和dest都为目录，则讲src下所有文件目录拷贝到dest下 2、src和dest都为文件，直接复制，名字为dest 3、src为文件，dest为目录，将src拷贝到dest目录下 

 1、src和dest都为目录，则讲src下所有文件（包括子目录）拷贝到dest下 2、src和dest都为文件，直接复制，名字为dest 3、src为文件，dest为目录，将src拷贝到dest目录下 

 FileUtil.rename(file, “aaa.png”, true) xx/xx.png =》xx/aaa.png 

 FileUtil.rename(file, “aaa”, true) xx/xx.png =》xx/aaa.png 

 FileUtil.rename(file, “aaa.jpg”, false) xx/xx.png =》xx/aaa.jpg 

 “/foo//” =》 “/foo/” “/foo/./” =》 “/foo/” “/foo/…/bar” =》 “/bar” “/foo/…/bar/” =》 “/bar/” “/foo/…/bar/…/baz” =》 “/baz” “/…/” =》 “/” “foo/bar/…” =》 “foo” “foo/…/bar” =》 “bar” “foo/…/…/bar” =》 “bar” “//server/foo/…/bar” =》 “/server/bar” “//server/…/bar” =》 “/bar” “C:\foo\…\bar” =》 “C:/bar” “C:\…\bar” =》 “C:/bar” “~/foo/…/bar/” =》 “~/bar/” “~/…/bar” =》 “bar” 

 dirPath: d:/aaa/bbb    filePath: d:/aaa/bbb/ccc     =》    ccc dirPath: d:/Aaa/bbb    filePath: d:/aaa/bbb/ccc.txt     =》    ccc.txt 

 dirPath: d:/aaa/bbb    filePath: d:/aaa/bbb/ccc     =》    ccc dirPath: d:/Aaa/bbb    filePath: d:/aaa/bbb/ccc.txt     =》    ccc.txt dirPath: d:/Aaa/bbb    filePath: d:/aaa/bbb/     =》    “” 

      1、无法识别类型默认按照扩展名识别      2、xls、doc、msi头信息无法区分，按照扩展名区分      3、zip可能为docx、xlsx、pptx、jar、war头信息无法区分，按照扩展名区分 

 getParent(“d:/aaa/bbb/cc/ddd”, 0) -》 “d:/aaa/bbb/cc/ddd” getParent(“d:/aaa/bbb/cc/ddd”, 2) -》 “d:/aaa/bbb” getParent(“d:/aaa/bbb/cc/ddd”, 4) -》 “d:/” getParent(“d:/aaa/bbb/cc/ddd”, 5) -》 null 

 getParent(file(“d:/aaa/bbb/cc/ddd”, 0)) -》 “d:/aaa/bbb/cc/ddd” getParent(file(“d:/aaa/bbb/cc/ddd”, 2)) -》 “d:/aaa/bbb” getParent(file(“d:/aaa/bbb/cc/ddd”, 4)) -》 “d:/” getParent(file(“d:/aaa/bbb/cc/ddd”, 5)) -》 null 

 Windows: \r\n Mac: \r Linux: \n 

方法明细

方法名称:cn.hutool.core.io.FileUtil.isWindows()

方法描述

是否为Windows环境

支持版本及以上

3.0.9

参数描述:

返回值:

是否为Windows环境

参考案例:

if( FileUtil.isWindows()){
			System.out.println("window环境");
		}else{
			System.out.println("其他环境");
		}
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.ls(java.lang.String)

方法描述

列出目录文件<br>
给定的绝对路径不能是压缩包中的路径

支持版本及以上

参数描述:

返回值:

文件列表（包含目录）

参考案例:

		//列出指定目录里的文件或目录 子目录里的文件不会列出来
		File[] files = FileUtil.ls("D:\\ruanjian");
		for(File file:files){
			System.out.println(file.getName());
		}
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.isEmpty(java.io.File)

方法描述

文件是否为空<br>
目录：里面没有文件时为空 文件：文件大小为0时为空

支持版本及以上

参数描述:

返回值:

是否为空，当提供目录或文件大小为0时为true

参考案例:

		//目录：里面没有文件时为空
		//文件：文件大小为0时为空
		Assert.assertEquals(Boolean.TRUE,FileUtil.isEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\fileTest")));
		Assert.assertEquals(Boolean.FALSE,FileUtil.isEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\copyTest1.txt")));
		Assert.assertEquals(Boolean.TRUE,FileUtil.isEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\isEmptyTest.txt")));
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.isNotEmpty(java.io.File)

方法描述

文件是否为非空<br> 目录：里面没有文件时为空 文件：文件大小为0时为空

支持版本及以上

参数描述:

返回值:

是否为空，当提供目录或文件大小为0时为false

参考案例:

		Assert.assertEquals(Boolean.FALSE,FileUtil.isNotEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\fileTest")));
		Assert.assertEquals(Boolean.TRUE,FileUtil.isNotEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\copyTest1.txt")));
		Assert.assertEquals(Boolean.FALSE,FileUtil.isNotEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\isEmptyTest.txt")));
1
2
3

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.isDirEmpty(java.io.File)

方法描述

目录是否为空

支持版本及以上

参数描述:

返回值:

是否为空

参考案例:

		//一定要是目录file不然会抛异常
		Assert.assertEquals(Boolean.TRUE,FileUtil.isDirEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\fileTest")));
		Assert.assertEquals(Boolean.FALSE,FileUtil.isDirEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu")));
		//抛异常 cn.hutool.core.io.IORuntimeException: NotDirectoryException:
		Assert.assertEquals(Boolean.FALSE,FileUtil.isDirEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\isEmptyTest.txt")));
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.loopFiles(java.lang.String, java.io.FileFilter)

方法描述

递归遍历目录以及子目录中的所有文件<br>
如果提供file为文件，直接返回过滤结果

支持版本及以上

3.2.0

参数描述:

返回值:

文件列表

参考案例:

		//递归遍历目录以及子目录中的所有文件 可以加过滤条件
		List<File> files = FileUtil.loopFiles("C:\\Users\\Administrator\\Desktop\\xuzhu", new FileFilter() {
			@Override
			public boolean accept(File pathname) {
				if(pathname.getName().indexOf("to")>-1){
					return true;
				}else{
					return false;
				}
			}
		});
		for(File file:files){
			System.out.println(file.getName());
		}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.loopFiles(java.io.File, java.io.FileFilter)

方法描述

递归遍历目录以及子目录中的所有文件<br>
如果提供file为文件，直接返回过滤结果

支持版本及以上

参数描述:

返回值:

文件列表

参考案例:

		//递归遍历目录以及子目录中的所有文件 可以加过滤条件
		List<File> files = FileUtil.loopFiles(new File("C:\\Users\\Administrator\\Desktop\\xuzhu"), new FileFilter() {
			@Override
			public boolean accept(File pathname) {
				if(pathname.getName().indexOf("to")>-1){
					return true;
				}else{
					return false;
				}
			}
		});
		for(File file:files){
			System.out.println(file.getName());
		}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.walkFiles(java.io.File, java.util.function.Consumer)

方法描述

递归遍历目录并处理目录下的文件，可以处理目录或文件：

• 非目录则直接调用{@link Consumer}处理
• 目录则递归调用此方法处理

返回值:

参考案例:

		List<File> files = new ArrayList<>();
				//递归遍历目录并处理目录下的文件（子目录也会遍历），可以处理目录或文件
		FileUtil.walkFiles(new File("C:\\Users\\Administrator\\Desktop\\xuzhu"), new Consumer<File>() {
			@Override
			public void accept(File file) {
				if(file.getName().indexOf("to")>-1){
					files.add(file);
				}
			}
		});
		for(File file:files){
			System.out.println(file.getName());
		}
1
2
3
4
5
6
7
8
9
10
11
12
13

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.loopFiles(java.io.File, int, java.io.FileFilter)

方法描述

递归遍历目录以及子目录中的所有文件<br>
如果提供file为文件，直接返回过滤结果

支持版本及以上

4.6.3

参数描述:

返回值:

文件列表

参考案例:

		//递归遍历目录以及子目录中的所有文件 可以加过滤条件
		List<File> files = FileUtil.loopFiles(new File("C:\\Users\\Administrator\\Desktop\\xuzhu"),3, new FileFilter() {
			@Override
			public boolean accept(File pathname) {
				if(pathname.getName().indexOf("to")>-1){
					return true;
				}else{
					return false;
				}
			}
		});
		for(File file:files){
			System.out.println(file.getName());
		}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.loopFiles(java.lang.String)

方法描述

递归遍历目录以及子目录中的所有文件

支持版本及以上

3.2.0

参数描述:

返回值:

文件列表

参考案例:

		//递归遍历目录以及子目录中的所有文件
		List<File> files = FileUtil.loopFiles("C:\\Users\\Administrator\\Desktop\\xuzhu");
		for(File file:files){
			System.out.println(file.getName());
		}
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.loopFiles(java.io.File)

方法描述

递归遍历目录以及子目录中的所有文件

支持版本及以上

参数描述:

返回值:

文件列表

参考案例:

		//递归遍历目录以及子目录中的所有文件
		List<File> files = FileUtil.loopFiles(new File("C:\\Users\\Administrator\\Desktop\\xuzhu"));
		for(File file:files){
			System.out.println(file.getName());
		}
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.listFileNames(java.lang.String)

方法描述

获得指定目录下所有文件名<br>
不会扫描子目录

支持版本及以上

参数描述:

返回值:

所有文件名列表

参考案例:

		//获得指定目录下所有文件名 不会扫描子目录
		List<String> paths = FileUtil.listFileNames("C:\\Users\\Administrator\\Desktop\\xuzhu");
		for(String path:paths){
			System.out.println(path);
		}
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.newFile(java.lang.String)

方法描述

创建File对象，相当于调用new File()，不做任何处理

支持版本及以上

4.1.4

参数描述:

返回值:

File

参考案例:

		//创建File对象，相当于调用new File()，不做任何处理
		File newfile = FileUtil.newFile("C:\\Users\\Administrator\\Desktop\\xuzhu\\newFile");
		newfile.mkdirs();
1
2
3

目录调用 前

目录调用后

源码解析：

//懂的都懂
public static File newFile(String path) {
		return new File(path);
	}
1
2
3
4

方法明细

方法名称:cn.hutool.core.io.FileUtil.file(java.lang.String)

方法描述

创建File对象，自动识别相对或绝对路径，相对路径将自动从ClassPath下寻找

支持版本及以上

参数描述:

返回值:

File

参考案例:

		//创建File对象，自动识别相对或绝对路径，相对路径将自动从ClassPath下寻找
		File srcFile = FileUtil.file("hutool.jpg");
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
		srcFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt");
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.file(java.lang.String, java.lang.String)

方法描述

创建File对象<br>
此方法会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/

支持版本及以上

参数描述:

返回值:

File

参考案例:

		//创建File对象，此方法会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/
		File srcFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu","contentEqualsIgnoreEOLTest1.txt");
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
		//莫须有的父目录，应该找不到此文件
		srcFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\aaa","contentEqualsIgnoreEOLTest1.txt");
		Assert.assertEquals(Boolean.FALSE,srcFile.exists());
1
2
3
4
5
6

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.file(java.io.File, java.lang.String)

方法描述

创建File对象<br>
根据的路径构建文件，在Win下直接构建，在Linux下拆分路径单独构建
此方法会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/

支持版本及以上

参数描述:

返回值:

File

参考案例:

		//创建File对象，此方法会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/
		File srcFile = FileUtil.file(new File("C:\\Users\\Administrator\\Desktop\\xuzhu"),"contentEqualsIgnoreEOLTest1.txt");
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
		//莫须有的父目录，应该找不到此文件
		srcFile = FileUtil.file(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\aaa"),"contentEqualsIgnoreEOLTest1.txt");
		Assert.assertEquals(Boolean.FALSE,srcFile.exists());
1
2
3
4
5
6

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.file(java.io.File, java.lang.String[])

方法描述

通过多层目录参数创建文件<br>
此方法会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/

支持版本及以上

4.0.6

参数描述:

返回值:

the file 文件

参考案例:

		//创建File对象，此方法会检查slip漏洞，漏洞说明见http://blog.nsfocus.net/zip-slip-2/
		File srcFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu","loopFileTest","loopFileTest1","toLoopFlie1.txt");
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
1
2
3

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.file(java.lang.String[])

方法描述

通过多层目录创建文件

元素名（多层目录名） ### 支持版本及以上 4.0.6 ### 参数描述: 参数名 | 描述 ---|--- java.lang.String[] names |

返回值:

the file 文件

参考案例:

		//创建File对象，多层文件的文件名，由外到内依次传入
		File srcFile = FileUtil.file("C:","Users","Administrator","Desktop","xuzhu","loopFileTest","loopFileTest1","toLoopFlie1.txt");
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
		srcFile = FileUtil.file("C:","Users","Administrator","Desktop","xuzhu_nb","loopFileTest","loopFileTest1","toLoopFlie1.txt");
		Assert.assertEquals(Boolean.FALSE,srcFile.exists());
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.file(java.net.URI)

方法描述

创建File对象

支持版本及以上

参数描述:

返回值:

File

参考案例:

		File srcFile = new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt");
		try {
			srcFile = FileUtil.file(srcFile.toURI());
		} catch (NullPointerException e) {
			e.printStackTrace();
		}
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.file(java.net.URL)

方法描述

创建File对象

支持版本及以上

参数描述:

返回值:

File

参考案例:

		File srcFile = null;
		File file=new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt");
		try {
			URL url = file.toURI().toURL();
			System.out.println("url:"+url);
			srcFile = FileUtil.file(url);
		} catch (Exception e) {
			e.printStackTrace();
		}
		Assert.assertEquals(Boolean.TRUE,srcFile.exists());
1
2
3
4
5
6
7
8
9
10

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.getTmpDirPath()

方法描述

获取临时文件路径（绝对路径）

支持版本及以上

4.0.6

参数描述:

返回值:

临时文件路径

参考案例:

		//获取临时文件路径（绝对路径）(当前电脑的临时文件路径)
		System.out.println("临时文件路径:"+FileUtil.getTmpDirPath());
1
2

源码解析：

/**
	 * 获取临时文件路径（绝对路径）
	 *
	 * @return 临时文件路径
	 * @since 4.0.6
	 */
	public static String getTmpDirPath() {
		return System.getProperty("java.io.tmpdir");
	}
1
2
3
4
5
6
7
8
9

方法明细

方法名称:cn.hutool.core.io.FileUtil.getTmpDir()

方法描述

获取临时文件目录

支持版本及以上

4.0.6

参数描述:

返回值:

临时文件目录

参考案例:

		//获取临时文件目录
		File temFile = FileUtil.getTmpDir();
		System.out.println("临时文件目录:"+temFile.getPath());
		Assert.assertEquals(Boolean.TRUE,temFile.exists());
1
2
3
4

源码解析：

	/**
	 * 获取临时文件目录
	 *
	 * @return 临时文件目录
	 * @since 4.0.6
	 */
	public static File getTmpDir() {
		return file(getTmpDirPath());
	}
1
2
3
4
5
6
7
8
9

方法明细

方法名称:cn.hutool.core.io.FileUtil.getUserHomePath()

方法描述

获取用户路径（绝对路径）

支持版本及以上

4.0.6

参数描述:

返回值:

用户路径

参考案例:

		//获取用户路径（绝对路径）
		System.out.println("获取用户路径（绝对路径）:"+FileUtil.getUserHomePath());
1
2

源码解析：

	/**
	 * 获取用户路径（绝对路径）
	 *
	 * @return 用户路径
	 * @since 4.0.6
	 */
	public static String getUserHomePath() {
		return System.getProperty("user.home");
	}

1
2
3
4
5
6
7
8
9
10

方法明细

方法名称:cn.hutool.core.io.FileUtil.getUserHomeDir()

方法描述

获取用户目录

支持版本及以上

4.0.6

参数描述:

返回值:

用户目录

参考案例:

		//获取用户目录
		File userHomeDir = FileUtil.getUserHomeDir();
		System.out.println("用户目录:"+userHomeDir.getPath());
		Assert.assertEquals(Boolean.TRUE,userHomeDir.exists());
1
2
3
4

源码解析：

	/**
	 * 获取用户目录
	 *
	 * @return 用户目录
	 * @since 4.0.6
	 */
	public static File getUserHomeDir() {
		return file(getUserHomePath());
	}
1
2
3
4
5
6
7
8
9

方法明细

方法名称:cn.hutool.core.io.FileUtil.exist(java.lang.String)

方法描述

判断文件是否存在，如果path为null，则返回false

支持版本及以上

参数描述:

返回值:

如果存在返回true

参考案例:

		String path ="C:\\Users\\Administrator\\Desktop\\xuzhu";
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(path));
		//不存在的路径
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(path+"123"));
		path = null;
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(path));

		//相比于file.exists()优势，多了路径的判空处理
		//下面会抛出空指针 NullPointerException
		File file = new File(path);
		Assert.assertEquals(Boolean.FALSE,file.exists());
1
2
3
4
5
6
7
8
9
10
11

源码解析：

	//代码很清晰，就是在原先的file.exists()基础上，加了路径的判空处理
	/**
	 * 判断文件是否存在，如果path为null，则返回false
	 *
	 * @param path 文件路径
	 * @return 如果存在返回true
	 */
	public static boolean exist(String path) {
		return (null != path) && file(path).exists();
	}
1
2
3
4
5
6
7
8
9
10

方法明细

方法名称:cn.hutool.core.io.FileUtil.exist(java.io.File)

方法描述

判断文件是否存在，如果file为null，则返回false

支持版本及以上

参数描述:

返回值:

如果存在返回true

参考案例:

		String path ="C:\\Users\\Administrator\\Desktop\\xuzhu";
		File file = new File(path);
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));
		//不存在的路径
		file = new File(path+"123");
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(file));
		file = null;
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(file));
1
2
3
4
5
6
7
8

源码解析：

	/**
	 * 判断文件是否存在，如果file为null，则返回false
	 *
	 * @param file 文件
	 * @return 如果存在返回true
	 */
	public static boolean exist(File file) {
		return (null != file) && file.exists();
	}
1
2
3
4
5
6
7
8
9

方法明细

方法名称:cn.hutool.core.io.FileUtil.exist(java.lang.String, java.lang.String)

方法描述

是否存在匹配文件

支持版本及以上

参数描述:

返回值:

如果存在匹配文件返回true

参考案例:

		String path ="C:\\Users\\Administrator\\Desktop\\xuzhu";
		//通过匹配文件名正则公式，判断是否存在匹配文件
		String regexp =  "contentEqualsIgnoreEOLTest(.*)";
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(path,regexp));
1
2
3
4

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.lastModifiedTime(java.io.File)

方法描述

指定文件最后修改时间

支持版本及以上

参数描述:

返回值:

最后修改时间

参考案例:

		File file=new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt");
		Date lastModifiedTime = FileUtil.lastModifiedTime(file);
		System.out.println(DateUtil.formatDateTime(lastModifiedTime));
1
2
3

源码解析：

在file.lastModified()的基础上，增加了file为null的判断
/**
	 * 指定文件最后修改时间
	 *
	 * @param file 文件
	 * @return 最后修改时间
	 */
	public static Date lastModifiedTime(File file) {
		if (false == exist(file)) {
			return null;
		}

		return new Date(file.lastModified());
	}
1
2
3
4
5
6
7
8
9
10
11
12
13
14

方法明细

方法名称:cn.hutool.core.io.FileUtil.lastModifiedTime(java.lang.String)

方法描述

指定路径文件最后修改时间

支持版本及以上

参数描述:

返回值:

最后修改时间

参考案例:

		String path ="C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt";
		Date lastModifiedTime = FileUtil.lastModifiedTime(path);
		System.out.println(DateUtil.formatDateTime(lastModifiedTime));
1
2
3

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.size(java.io.File)

方法描述

计算目录或文件的总大小<br>
当给定对象为文件时，直接调用 {@link File#length()}<br>
当给定对象为目录时，遍历目录下的所有文件和目录，递归计算其大小，求和返回

支持版本及以上

参数描述:

返回值:

总大小，bytes长度

参考案例:

		//计算目录或文件的总大小（子目录，子目录的子目录也会遍历） bytes长度
		String path ="C:\\Users\\Administrator\\Desktop\\xuzhu";
		//目录
		System.out.println(FileUtil.size(new File(path)));
		//文件
		path ="C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt";
		System.out.println(FileUtil.size(new File(path)));
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.newerThan(java.io.File, java.io.File)

方法描述

给定文件或目录的最后修改时间是否晚于给定时间

支持版本及以上

参数描述:

返回值:

是否晚于给定时间

参考案例:

		//文件或目录的最后修改时间是否晚于(大于)给定文件的最后修改时间
		//给定文件不存在时，文件一定比一个不存在的文件新
		File file1=new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt");
		File file2=new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest2.txt");
		System.out.println("file1最后修改时间"+DateUtil.date(file1.lastModified()).toString());
		System.out.println("file2最后修改时间"+DateUtil.date(file2.lastModified()).toString());
		Assert.assertEquals(Boolean.FALSE,FileUtil.newerThan(file1,file2));
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.newerThan(java.io.File, long)

方法描述

给定文件或目录的最后修改时间是否晚于给定时间

支持版本及以上

参数描述:

返回值:

是否晚于给定时间

参考案例:

		//文件或目录的最后修改时间是否晚于(大于)给定文件的最后修改时间
		//给定文件不存在时，文件一定比一个不存在的文件新
		File file1=new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest1.txt");
		File file2=new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\contentEqualsIgnoreEOLTest2.txt");
		System.out.println("file1最后修改时间"+DateUtil.date(file1.lastModified()).toString());
		System.out.println("file2最后修改时间"+DateUtil.date(file2.lastModified()).toString());
		Assert.assertEquals(Boolean.FALSE,FileUtil.newerThan(file1,file2.lastModified()));
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.touch(java.lang.String)

方法描述

创建文件及其父目录，如果这个文件存在，直接返回这个文件<br>
此方法不对File对象类型做判断，如果File不存在，无法判断其类型

支持版本及以上

参数描述:

返回值:

文件，若路径为null，返回null

参考案例:

		// fullFilePath 文件的全路径，使用POSIX风格
		//无中生有 touchTest.txt 不存在
		File file = FileUtil.touch("C:\\Users\\Administrator\\Desktop\\xuzhu\\touchTest.txt");
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));
		//无中生有 touchTest目录和 touchTest.txt 不存在
		file = FileUtil.touch("C:\\Users\\Administrator\\Desktop\\xuzhu\\touchTest\\touchTest.txt");
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));

		String path = null;
		//若路径为null，返回null
		file = FileUtil.touch(path);
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(file));
1
2
3
4
5
6
7
8
9
10
11
12

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.touch(java.io.File)

方法描述

创建文件及其父目录，如果这个文件存在，直接返回这个文件<br>
此方法不对File对象类型做判断，如果File不存在，无法判断其类型

支持版本及以上

参数描述:

返回值:

文件，若路径为null，返回null

参考案例:

		// fullFilePath 文件的全路径，使用POSIX风格
		//无中生有 touchTest.txt 不存在
		File file = FileUtil.touch(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\touchTest.txt"));
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));
		//无中生有 touchTest目录和 touchTest.txt 不存在
		file = FileUtil.touch(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\touchTest\\touchTest.txt"));
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));

		file = null;
		//若file为null，返回null
		file = FileUtil.touch(file);
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(file));
1
2
3
4
5
6
7
8
9
10
11
12

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.touch(java.io.File, java.lang.String)

方法描述

创建文件及其父目录，如果这个文件存在，直接返回这个文件<br>
此方法不对File对象类型做判断，如果File不存在，无法判断其类型

支持版本及以上

参数描述:

返回值:

File

参考案例:

		// fullFilePath 文件的全路径，使用POSIX风格
		//无中生有 touchTest.txt 不存在
		File file = FileUtil.touch(new File("C:\\Users\\Administrator\\Desktop\\xuzhu"),"touchTest.txt");
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));
		//无中生有 touchTest目录和 touchTest.txt 不存在
		file = FileUtil.touch(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\touchTest"),"touchTest.txt");
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));

		String path = null;
		//若路径为null，返回null
		file = FileUtil.touch(path);
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(file));
1
2
3
4
5
6
7
8
9
10
11
12

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.touch(java.lang.String, java.lang.String)

方法描述

创建文件及其父目录，如果这个文件存在，直接返回这个文件<br>
此方法不对File对象类型做判断，如果File不存在，无法判断其类型

支持版本及以上

参数描述:

返回值:

File

参考案例:

		// fullFilePath 文件的全路径，使用POSIX风格
		//无中生有 touchTest.txt 不存在
		File file = FileUtil.touch("C:\\Users\\Administrator\\Desktop\\xuzhu","touchTest.txt");
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));
		//无中生有 touchTest目录和 touchTest.txt 不存在
		file = FileUtil.touch("C:\\Users\\Administrator\\Desktop\\xuzhu\\touchTest","touchTest.txt");
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));

		String path = null;
		//若路径为null，返回null
		file = FileUtil.touch(path);
		Assert.assertEquals(Boolean.FALSE,FileUtil.exist(file));
1
2
3
4
5
6
7
8
9
10
11
12

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.mkParentDirs(java.io.File)

方法描述

创建所给文件或目录的父目录

支持版本及以上

参数描述:

返回值:

父目录

参考案例:

		//创建所给文件或目录的父目录，返回父目录
		// 注：与touch差别，这个只会创建父目录，文件不会帮忙创建
		File file = FileUtil.mkParentDirs(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\mkParentDirs\\mkParentDirsTest.txt"));
		System.out.println("文件名称："+file.getName());
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.mkParentDirs(java.lang.String)

方法描述

创建父文件夹，如果存在直接返回此文件夹

支持版本及以上

参数描述:

返回值:

创建的目录

参考案例:

		//创建所给文件或目录的父目录，返回父目录
		// 注：与touch差别，这个只会创建父目录，文件不会帮忙创建
		File file = FileUtil.mkParentDirs("C:\\Users\\Administrator\\Desktop\\xuzhu\\mkParentDirs\\mkParentDirsTest.txt");
		System.out.println("文件名称："+file.getName());
		Assert.assertEquals(Boolean.TRUE,FileUtil.exist(file));
1
2
3
4
5

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.del(java.lang.String)

方法描述

删除文件或者文件夹<br>
路径如果为相对路径，会转换为ClassPath路径！ 注意：删除文件夹时不会判断文件夹是否为空，如果不空则递归删除子文件或文件夹<br>
某个文件删除失败会终止删除操作

支持版本及以上

参数描述:

返回值:

成功与否

参考案例:

		// 删除一个不存在的文件，应返回true
		boolean result = FileUtil.del("e:/Hutool_test_3434543533409843.txt");
		Assert.assertTrue(result);

		//删除一个存在的文件，应返回true
		result = FileUtil.del("C:\\Users\\Administrator\\Desktop\\xuzhu\\delTest\\del1.txt");
		Assert.assertTrue(result);
		//删除一个存在的文件夹，应返回true
		result = FileUtil.del("C:\\Users\\Administrator\\Desktop\\xuzhu\\delTest\\");
		Assert.assertTrue(result);
1
2
3
4
5
6
7
8
9
10

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.del(java.io.File)

方法描述

删除文件或者文件夹<br>
注意：删除文件夹时不会判断文件夹是否为空，如果不空则递归删除子文件或文件夹<br>
某个文件删除失败会终止删除操作

支持版本及以上

参数描述:

返回值:

成功与否

参考案例:

		// 删除一个不存在的文件，应返回true
		boolean result = FileUtil.del(new File("e:/Hutool_test_3434543533409843.txt"));
		Assert.assertTrue(result);

		//删除一个存在的文件，应返回true
		result = FileUtil.del(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\delTest\\del1.txt"));
		Assert.assertTrue(result);
		//删除一个存在的文件夹，应返回true
		result = FileUtil.del(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\delTest\\"));
		Assert.assertTrue(result);
1
2
3
4
5
6
7
8
9
10

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.clean(java.lang.String)

方法描述

清空文件夹<br>
注意：清空文件夹时不会判断文件夹是否为空，如果不空则递归删除子文件或文件夹<br>
某个文件删除失败会终止删除操作

支持版本及以上

4.0.8

参数描述:

返回值:

成功与否

参考案例:

		//清空一个存在的文件夹，应返回true
		boolean result = FileUtil.clean("C:\\Users\\Administrator\\Desktop\\xuzhu\\cleanTest\\");
		Assert.assertTrue(result);
1
2
3

清空前

清空后

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.clean(java.io.File)

方法描述

清空文件夹<br>
注意：清空文件夹时不会判断文件夹是否为空，如果不空则递归删除子文件或文件夹<br>
某个文件删除失败会终止删除操作

支持版本及以上

3.0.6

参数描述:

返回值:

成功与否

参考案例:

		//清空一个存在的文件夹，应返回true
		boolean result = FileUtil.clean(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\cleanTest\\"));
		Assert.assertTrue(result);
1
2
3

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.cleanEmpty(java.io.File)

方法描述

清理空文件夹<br>
此方法用于递归删除空的文件夹，不删除文件<br>
如果传入的文件夹本身就是空的，删除这个文件夹

支持版本及以上

4.5.5

参数描述:

返回值:

成功与否

参考案例1:

		//清理空文件夹 此文件夹包含一个空文件夹，一个非空文件夹和一个文件
		boolean result = FileUtil.cleanEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\cleanEmptyTest\\"));
		Assert.assertTrue(result);
1
2
3

参考案例2：

		//清理空文件夹 传入的文件夹本身就是空的，删除这个文件夹
		boolean result = FileUtil.cleanEmpty(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\cleanEmptyTest1\\"));
		Assert.assertTrue(result);
1
2
3

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.mkdir(java.lang.String)

方法描述

创建文件夹，如果存在直接返回此文件夹<br>
此方法不对File对象类型做判断，如果File不存在，无法判断其类型

支持版本及以上

参数描述:

返回值:

创建的目录

参考案例1:

		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\mkdirTest\\mkdirTest1";
		//创建文件夹，会递归自动创建其不存在的父文件夹，如果存在直接返回此文件夹
		File dirFir = FileUtil.mkdir(path);
		Assert.assertEquals(Boolean.TRUE,dirFir.exists());
1
2
3
4

参考案例2:

		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\mkdirTest\\mkdirTest1\\mkdirTest1.txt";
		//文件路径 最后的文件名，也会变成文件夹的名称
		File dirFir = FileUtil.mkdir(path);
		Assert.assertEquals(Boolean.TRUE,dirFir.exists());
1
2
3
4

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.mkdir(java.io.File)

方法描述

创建文件夹，会递归自动创建其不存在的父文件夹，如果存在直接返回此文件夹<br>
此方法不对File对象类型做判断，如果File不存在，无法判断其类型

支持版本及以上

参数描述:

返回值:

创建的目录

参考案例:

		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\mkdirTest\\mkdirTest1";
		//创建文件夹，会递归自动创建其不存在的父文件夹，如果存在直接返回此文件夹
		File dirFir = FileUtil.mkdir(new File(path));
		Assert.assertEquals(Boolean.TRUE,dirFir.exists());
1
2
3
4

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.createTempFile(java.io.File)

方法描述

创建临时文件<br>
创建后的文件名为 prefix[Randon].tmp

支持版本及以上

参数描述:

返回值:

临时文件

参考案例:

		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\createTempFileTest\\";
		//创建临时文件 创建后的文件名为 hutool[Randon].tmp
		File tempFile = FileUtil.createTempFile(new File(path));
		System.out.println("Path:"+tempFile.getPath());
		System.out.println("file name:"+tempFile.getName());
		Assert.assertEquals(Boolean.TRUE,tempFile.exists());
1
2
3
4
5
6

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.createTempFile(java.io.File, boolean)

方法描述

创建临时文件<br>
创建后的文件名为 prefix[Randon].tmp

支持版本及以上

参数描述:

返回值:

临时文件

参考案例:

		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\createTempFileTest\\";
		//创建临时文件 创建后的文件名为 hutool[Randon].tmp isReCreat 是否重新创建文件（删掉原来的，创建新的）
		File tempFile = FileUtil.createTempFile(new File(path),Boolean.TRUE);
		System.out.println("Path:"+tempFile.getPath());
		System.out.println("file name:"+tempFile.getName());
		Assert.assertEquals(Boolean.TRUE,tempFile.exists());
		tempFile = FileUtil.createTempFile(new File(path),Boolean.TRUE);
		System.out.println("Path:"+tempFile.getPath());
		System.out.println("file name:"+tempFile.getName());
		Assert.assertEquals(Boolean.TRUE,tempFile.exists());
1
2
3
4
5
6
7
8
9
10

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.createTempFile(java.lang.String, java.lang.String, java.io.File, boolean)

方法描述

创建临时文件<br>
创建后的文件名为 prefix[Randon].suffix From com.jodd.io.FileUtil

支持版本及以上

参数描述:

返回值:

临时文件

参考案例:

		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\createTempFileTest\\";
		String prefix="xuzhu";
		String suffix=".nb";
		//创建临时文件 创建后的文件名为 hutool[Randon].tmp isReCreat 是否重新创建文件（删掉原来的，创建新的）
		File tempFile = FileUtil.createTempFile(prefix,suffix,new File(path),Boolean.TRUE);
		System.out.println("Path:"+tempFile.getPath());
		System.out.println("file name:"+tempFile.getName());
		Assert.assertEquals(Boolean.TRUE,tempFile.exists());
		tempFile = FileUtil.createTempFile(prefix,suffix,new File(path),Boolean.TRUE);
		System.out.println("Path:"+tempFile.getPath());
		System.out.println("file name:"+tempFile.getName());
		Assert.assertEquals(Boolean.TRUE,tempFile.exists());
1
2
3
4
5
6
7
8
9
10
11
12

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.copyFile(java.lang.String, java.lang.String, java.nio.file.StandardCopyOption[])

方法描述

通过JDK7+的 Files#copy(Path, Path, CopyOption…) 方法拷贝文件

支持版本及以上

参数描述:

返回值:

File

参考案例1:

		//copyTest1.txt存在，copyTest2.txt不存在
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest\\copyTest1.txt";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest\\copyTest2.txt";
		//返回目标dest的file 复制操作
		//StandardCopyOption.COPY_ATTRIBUTES:完整复制源文件属性到新文件 注意：目标文件一定不能存在，不然会报错（FileAlreadyExistsException: ***）
		File copyFile = FileUtil.copyFile(srcPath,destPath, StandardCopyOption.COPY_ATTRIBUTES);
		Assert.assertEquals(Boolean.TRUE,copyFile.exists());
1
2
3
4
5
6
7

复制前：

复制后：

复制完后，再执行代码

参考案例2：

		//copyTest1.txt存在，copyTest2.txt，copyTest3.txt不存在
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest1\\copyTest1.txt";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest1\\copyTest2.txt";
		String destPath3 = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest1\\copyTest3.txt";
		//返回目标dest的file 复制操作
		File copyFile = FileUtil.copyFile(srcPath,destPath, StandardCopyOption.COPY_ATTRIBUTES);
		FileUtil.copyFile(srcPath,destPath3, StandardCopyOption.COPY_ATTRIBUTES);
		Assert.assertEquals(Boolean.TRUE,copyFile.exists());

		//如果目标路径已经存在（也就是copyTest2.txt文件），那么复制或者移动将失败。
		// 如果想要覆盖已经存在的目标路径，可以使用REPLACE_EXISTING选项。如果想要复制所有文件的属性，可以使用COPY_ATTRIBUTES选项。也可以同时使用两个选项
		srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest1\\copyTest1.txt";
		destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest1\\copyTest2.txt";
		copyFile = FileUtil.copyFile(srcPath,destPath, StandardCopyOption.REPLACE_EXISTING);
		Assert.assertEquals(Boolean.TRUE,copyFile.exists());
		srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest1\\copyTest1.txt";
		destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest1\\copyTest3.txt";
		copyFile = FileUtil.copyFile(srcPath,destPath, StandardCopyOption.REPLACE_EXISTING,StandardCopyOption.COPY_ATTRIBUTES);
		Assert.assertEquals(Boolean.TRUE,copyFile.exists());
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19

复制前：

复制后：

参考案例3：

		//copyTest1.txt存在，copyTest2.txt不存在
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest2\\copyTest1.txt";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest2\\copyTest2.txt";
		//返回目标dest的file 复制操作
		//StandardCopyOption.ATOMIC_MOVE:将文件作为原子文件系统操作移动 会报错：（UnsupportedOperationException: Unsupported copy option）因为copy方法不能用这个参数
		//说到这个顺便说明下，copy支持的属性有：(详见：WindowsFileCopy.java)
		// StandardCopyOption.REPLACE_EXISTING  
		// LinkOption.NOFOLLOW_LINKS 
		// StandardCopyOption.COPY_ATTRIBUTES 
		// ExtendedCopyOption.INTERRUPTIBLE
		File copyFile = FileUtil.copyFile(srcPath,destPath, StandardCopyOption.ATOMIC_MOVE);
		Assert.assertEquals(Boolean.TRUE,copyFile.exists());
1
2
3
4
5
6
7
8
9
10
11
12

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.copyFile(java.io.File, java.io.File, java.nio.file.StandardCopyOption[])

方法描述

通过JDK7+的 Files#copy(Path, Path, CopyOption…) 方法拷贝文件

支持版本及以上

参数描述:

返回值:

目标文件

参考案例:

		//copyTest1.txt存在，copyTest2.txt不存在
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest3\\copyTest1.txt";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFileTest3\\copyTest2.txt";
		//返回目标dest的file 复制操作
		//StandardCopyOption.COPY_ATTRIBUTES:完整复制源文件属性到新文件 注意：目标文件一定不能存在，不然会报错（FileAlreadyExistsException: ***）
		File copyFile = FileUtil.copyFile(new File(srcPath),new File(destPath), StandardCopyOption.COPY_ATTRIBUTES);
		Assert.assertEquals(Boolean.TRUE,copyFile.exists());
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.copy(java.lang.String, java.lang.String, boolean)

方法描述

复制文件或目录<br>
如果目标文件为目录，则将源文件以相同文件名拷贝到目标目录

支持版本及以上

参数描述:

返回值:

目标目录或文件

参考案例:

		String srcPath = "hutool.jpg";
		String destPath = "hutool.copy.jpg";
		File destFile = FileUtil.copy(srcPath, destPath, true);
		Assert.assertTrue(destFile.exists());
1
2
3
4

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.copy(java.io.File, java.io.File, boolean)

方法描述

复制文件或目录<br>
情况如下：

 1、src和dest都为目录，则将src目录及其目录下所有文件目录拷贝到dest下
 2、src和dest都为文件，直接复制，名字为dest
 3、src为文件，dest为目录，将src拷贝到dest目录下
 

支持版本及以上

参数描述:

返回值:

目标目录或文件

参考案例:

		File srcFile = FileUtil.file("hutool.jpg");
		File destFile = FileUtil.file("hutool.copy.jpg");

		FileUtil.copy(srcFile, destFile, true);

		Assert.assertTrue(destFile.exists());
		Assert.assertEquals(srcFile.length(), destFile.length());
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.copyContent(java.io.File, java.io.File, boolean)

方法描述

复制文件或目录<br>
情况如下：

 1、src和dest都为目录，则讲src下所有文件目录拷贝到dest下
 2、src和dest都为文件，直接复制，名字为dest
 3、src为文件，dest为目录，将src拷贝到dest目录下
 

支持版本及以上

参数描述:

返回值:

目标目录或文件

参考案例1:

		//1、src和dest都为目录，则讲src下所有文件目录拷贝到dest下
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest1";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest1_dest";
		//返回对象file是目标目录或文件
		FileUtil.copyContent(new File(srcPath),new File(destPath),true);
1
2
3
4
5

复制前

复制后：目标目录如果不存在，程序会帮忙创建目录

参考案例2：

		//2、src和dest都为文件，直接复制，名字为dest
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest1\\copyTest1.txt";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest1\\copyTest2.txt";
		//返回对象file是目标目录或文件
		FileUtil.copyContent(new File(srcPath),new File(destPath),true);
1
2
3
4
5

参考案例3：

		//3、src为文件，dest为目录，将src拷贝到dest目录下
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest1\\copyTest1.txt";
		//dest为目录且要存在，不然复制不会成功
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest3\\";
		//返回对象file是目标目录或文件
		FileUtil.copyContent(new File(srcPath),new File(destPath),true);
1
2
3
4
5
6

参考案例4：

		//1、src和dest都为目录，则讲src下所有文件目录拷贝到dest下（包含子目录，子目录会拷贝，子目录包含的文件也会拷贝）
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest4";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyContentTest4_dest";
		//返回对象file是目标目录或文件
		FileUtil.copyContent(new File(srcPath),new File(destPath),true);

1
2
3
4
5
6

复制前：

复制后：

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.copyFilesFromDir(java.io.File, java.io.File, boolean)

方法描述

复制文件或目录<br>
情况如下：

 1、src和dest都为目录，则讲src下所有文件（包括子目录）拷贝到dest下
 2、src和dest都为文件，直接复制，名字为dest
 3、src为文件，dest为目录，将src拷贝到dest目录下
 

支持版本及以上

4.1.5

参数描述:

返回值:

目标目录或文件

参考案例:

//1、src和dest都为目录，则讲src下所有文件（包括子目录）拷贝到dest下
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFilesFromDirTest1";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFilesFromDirTest1_dest";
		//返回对象file是目标目录或文件
		FileUtil.copyContent(new File(srcPath),new File(destPath),true);
1
2
3
4
5

参考案例2：

		//1、src和dest都为目录，则讲src下所有文件（包括子目录）拷贝到dest下
		String srcPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFilesFromDirTest2";
		String destPath = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyFilesFromDirTest2_dest";
		//返回对象file是目标目录或文件
		FileUtil.copyContent(new File(srcPath),new File(destPath),true);
1
2
3
4
5

复制前：

复制后：

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.move(java.io.File, java.io.File, boolean)

方法描述

移动文件或者目录

支持版本及以上

参数描述:

返回值:

参考案例:

		//1、目录移到目录
		File srcFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\moveTest");
		//目标目录不存在程序也会帮忙创建
		File destFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\targetMoveTest");

		FileUtil.move(srcFile, destFile, true);
1
2
3
4
5
6

移动前：

移动后：

参考案例2：

		//2、A目录的源文件移到B目录下
		File srcFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\moveTest2\\moveTest2.txt");
		//目标目录/dest为目录且要存在，不然移动不会成功，会变成文件
		File destFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\targetMoveTest2\\");

		FileUtil.move(srcFile, destFile, true);
1
2
3
4
5
6

移动前：

移动后：

参考案例3：

		//3、A目录的源文件移到B目录的目标文件
		File srcFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\moveTest3\\moveTest3.txt");
		//目标目录不存在程序也会帮忙创建
		File destFile = FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\targetMoveTest3\\moveTest3.txt");

		FileUtil.move(srcFile, destFile, true);
1
2
3
4
5
6

移动前：

移动后：

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.rename(java.io.File, java.lang.String, boolean)

方法描述

修改文件或目录的文件名，不变更路径，只是简单修改文件名，不保留扩展名。<br>

 FileUtil.rename(file, "aaa.png", true) xx/xx.png =》xx/aaa.png
 

支持版本及以上

5.3.6

参数描述:

返回值:

目标文件

参考案例:

		FileUtil.rename(FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\renameTest\\hutool.jpg"), "hutool2.jpg", false);
1

修改前：

修改后：

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.rename(java.io.File, java.lang.String, boolean, boolean)

方法描述

修改文件或目录的文件名，不变更路径，只是简单修改文件名<br>
重命名有两种模式：<br>
1、isRetainExt为true时，保留原扩展名：

 FileUtil.rename(file, "aaa", true) xx/xx.png =》xx/aaa.png
 

2、isRetainExt为false时，不保留原扩展名，需要在newName中

 FileUtil.rename(file, "aaa.jpg", false) xx/xx.png =》xx/aaa.jpg
 

支持版本及以上

3.0.9

参数描述:

返回值:

目标文件

参考案例:

		//isRetainExt 是否保留原文件的扩展名，如果保留，则newName不需要加扩展名
		FileUtil.rename(FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\renameTest3\\hutool.jpg"), "hutool2",Boolean.TRUE, false);
		FileUtil.rename(FileUtil.file("C:\\Users\\Administrator\\Desktop\\xuzhu\\renameTest3\\hutool1.jpg"), "hutool3.jpg",Boolean.FALSE, false);
1
2
3

修改前：

修改后：

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.getCanonicalPath(java.io.File)

方法描述

获取规范的绝对路径

支持版本及以上

4.1.4

参数描述:

返回值:

规范绝对路径，如果传入file为null，返回null

参考案例:

		//获取规范的绝对路径
		System.out.println(FileUtil.getCanonicalPath(new File("C:\\Users\\Administrator\\Desktop\\xuzhu\\copyTest1.txt")));
		//如果传入file为null，返回null
		File file = null;
		System.out.println(FileUtil.getCanonicalPath(file));
		//如果传入不存在路径,也是能取到的
		System.out.println(FileUtil.getCanonicalPath(new File("C:\\Users\\Administrator\\Desktop\\getCanonicalPathTest\\copyTest1.txt")));
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.getAbsolutePath(java.lang.String, java.lang.Class)

方法描述

获取绝对路径<br>
此方法不会判定给定路径是否有效（文件或目录存在）

支持版本及以上

参数描述:

返回值:

绝对路径

参考案例:

			//获取绝对路径，相对于ClassPath的目录 jar包里的文件也能搜索到
		String absolutePath = FileUtil.getAbsolutePath("FileUtil.class",FileUtil.class);
		Assert.assertNotNull(absolutePath);
		System.out.println("absolutePath:"+absolutePath);	
1
2
3
4

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.getAbsolutePath(java.lang.String)

方法描述

获取绝对路径，相对于ClassPath的目录<br>
如果给定就是绝对路径，则返回原路径，原路径把所有\替换为/<br>
兼容Spring风格的路径表示，例如：classpath:config/example.setting也会被识别后转换

支持版本及以上

参数描述:

返回值:

绝对路径

参考案例:

		//获取绝对路径，相对于ClassPath的目录 jar包里的文件也能搜索到
		String absolutePath = FileUtil.getAbsolutePath("LICENSE-junit.txt");
		Assert.assertNotNull(absolutePath);
		System.out.println("absolutePath:"+absolutePath);
		String absolutePath2 = FileUtil.getAbsolutePath(absolutePath);
		Assert.assertNotNull(absolutePath2);
		System.out.println("absolutePath2:"+absolutePath2);
		Assert.assertEquals(absolutePath, absolutePath2);

		String path = FileUtil.getAbsolutePath("中文.xml");
		Assert.assertTrue(path.contains("中文.xml"));
		System.out.println("path:"+path);

		path = FileUtil.getAbsolutePath("d:");
		Assert.assertEquals("d:", path);
		System.out.println("path:"+path);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16

"中文.xml"这个文件是不存在的，但是路径还是可以取到“相对于ClassPath的”

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.getAbsolutePath(java.io.File)

方法描述

获取标准的绝对路径

支持版本及以上

参数描述:

返回值:

绝对路径

参考案例:

		//获取标准的绝对路径 跟getAbsolutePath（String）不一样
		String absolutePath = FileUtil.getAbsolutePath(new File("LICENSE-junit.txt"));
		Assert.assertNotNull(absolutePath);
		System.out.println("absolutePath:"+absolutePath);
		String absolutePath2 = FileUtil.getAbsolutePath(new File(absolutePath));
		Assert.assertNotNull(absolutePath2);
		System.out.println("absolutePath2:"+absolutePath2);
		Assert.assertEquals(absolutePath, absolutePath2);

		String path = FileUtil.getAbsolutePath(new File("中文.xml"));
		Assert.assertTrue(path.contains("中文.xml"));
		System.out.println("path:"+path);

		path = FileUtil.getAbsolutePath(new File("d:"));
		System.out.println("path:"+path);
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15

源码解析：

if (file == null) {
			return null;
		}

		try {
			return file.getCanonicalPath();
		} catch (IOException e) {
			return file.getAbsolutePath();
		}
		源码很简单，就是一个判空和直接返回file.getCanonicalPath()
将在源码解析里分析：getCanonicalPath和getAbsolutePath的区别
链接：待补充
1
2
3
4
5
6
7
8
9
10
11
12

方法明细

方法名称:cn.hutool.core.io.FileUtil.isAbsolutePath(java.lang.String)

方法描述

给定路径已经是绝对路径<br>
此方法并没有针对路径做标准化，建议先执行{@link #normalize(String)}方法标准化路径后判断

支持版本及以上

参数描述:

返回值:

是否已经是绝对路径

参考案例:

		//修复后的路径
		String path = FileUtil.normalize("C:\\Users\\Administrator\\Desktop\\xuzhu\\isAbsolutePathTest\\isAbsolutePathTest.txt");
		//是否已经是绝对路径
		Assert.assertEquals(Boolean.TRUE,FileUtil.isAbsolutePath(path));
		path = FileUtil.normalize("FileUtil.class");
		//是否已经是绝对路径
		Assert.assertEquals(Boolean.FALSE,FileUtil.isAbsolutePath(path));
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.isDirectory(java.lang.String)

方法描述

判断是否为目录，如果path为null，则返回false

支持版本及以上

参数描述:

返回值:

如果为目录true

参考案例:

		//判断是否为目录
		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\";
		Assert.assertEquals(Boolean.TRUE,FileUtil.isDirectory(path));
		path = null;
		Assert.assertEquals(Boolean.FALSE,FileUtil.isDirectory(path));
		path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyTest1.txt";
		Assert.assertEquals(Boolean.FALSE,FileUtil.isDirectory(path));

1
2
3
4
5
6
7
8

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.isDirectory(java.io.File)

方法描述

判断是否为目录，如果file为null，则返回false

支持版本及以上

参数描述:

返回值:

如果为目录true

参考案例:

		//判断是否为目录
		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\";
		Assert.assertEquals(Boolean.TRUE,FileUtil.isDirectory(new File(path)));
		File file = null;
		Assert.assertEquals(Boolean.FALSE,FileUtil.isDirectory(file));
		path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyTest1.txt";
		Assert.assertEquals(Boolean.FALSE,FileUtil.isDirectory(new File(path)));
1
2
3
4
5
6
7

源码解析：

链接：待补充
1

方法明细

方法名称:cn.hutool.core.io.FileUtil.isFile(java.lang.String)

方法描述

判断是否为文件，如果path为null，则返回false

支持版本及以上

参数描述:

返回值:

如果为文件true

参考案例:

		//判断是否为文件
		String path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\";
		Assert.assertEquals(Boolean.FALSE,FileUtil.isFile(path));
		path = null;
		Assert.assertEquals(Boolean.FALSE,FileUtil.isFile(path));
		path = "C:\\Users\\Administrator\\Desktop\\xuzhu\\copyTest1.txt";
		Assert.assertEquals(Boolean.TRUE,FileUtil.isFile(path));
1
2
3
4
5
6
7