Files.copy()是Java 7+推荐的网络流存文件方式,自动缓冲、代码简洁;需预建父目录、指定REPLACE_EXISTING、用try-with-resources关闭输入流。

用 Files.copy() 把网络输入流直接存成本地文件,是 Java 7+ 推荐的简洁高效方式。它内部自动使用缓冲、避免手动读写循环,性能优于传统字节流循环,且代码极少出错。
确保目标路径就绪
目标文件夹可能不存在,而 Files.copy() 不会自动创建父目录——必须提前处理:
- 用
Paths.get(targetFilePath)获取目标Path - 调用
Files.createDirectories(path.getParent())创建完整父路径(支持多级) - 注意:
createDirectories()对已存在目录无副作用,安全可重复调用
选择正确的重载方法
网络流属于 InputStream,应使用以下签名:
-
in来自URL.openStream()、HttpURLConnection.getInputStream()或框架如 Spring 的MultipartFile.getInputStream() -
target是通过Paths.get("xxx/yyy.jpg")构建的绝对或相对路径 - 必加
StandardCopyOption.REPLACE_EXISTING,否则目标文件已存在时抛FileAlreadyExistsException
正确管理流生命周期
输入流由谁关闭?关键规则:
-
Files.copy(in, ...)不会关闭 传入的InputStream - 所以必须由你显式关闭,推荐用
try-with-resources包裹输入流 - 若输入流来自 HTTP 客户端(如 OkHttp),需确认其响应体是否支持多次读取;一般只读一次,关完即弃
完整示例代码
下载网页图片并保存到 ./downloads/logo.png:
Path target = Paths.get("downloads/logo.png");
Files.createDirectories(target.getParent()); // 创建 downloads 目录
try (InputStream in = new URL("https://example.com/logo.png").openStream()) {
Files.copy(in, target, StandardCopyOption.REPLACE_EXISTING);
System.out.println("下载完成,共 " + Files.size(target) + " 字节");
} catch (IOException e) {
System.err.println("保存失败:" + e.getMessage());
}
该写法天然支持大文件,因 Files.copy 内部使用 8KB 左右缓冲区分块传输,无需手动配置。

















