Java拷贝工具需区分字节流(通用,适合所有文件)和字符流(仅文本,须显式指定编码),推荐用Files.copy()一行实现字节级复制,注意路径检查、缓冲区大小及符号链接处理。

Java 中编写拷贝工具,核心在于区分字节流(InputStream/OutputStream)和字符流(Reader/Writer),并根据文件类型合理选择。二进制文件(如图片、PDF、JAR)必须用字节流;纯文本文件(如 .txt、.csv、.xml)可用字符流,但需注意编码一致性。下面直接给出实用、可运行的写法。
字节流拷贝:通用安全,适合所有文件
使用 FileInputStream 和 FileOutputStream,配合缓冲数组(推荐 8192 字节),避免逐字节读写导致性能极差。关键点是正确处理流的关闭和异常。
- 用 try-with-resources 自动关闭流,无需手动
finally块 - 每次
read()返回实际读取字节数,必须用该值写入,不能直接写满缓冲区 - 不依赖
available()判断大小,它不可靠
示例代码:
<font size="2"><pre class="brush:php;toolbar:false;">public static void copyByBytes(Path src, Path dest) throws IOException {
try (InputStream is = Files.newInputStream(src);
OutputStream os = Files.newOutputStream(dest)) {
byte[] buf = new byte[8192];
int len;
while ((len = is.read(buf)) != -1) {
os.write(buf, 0, len);
}
}
}
字符流拷贝:仅限文本,必须指定编码
用 InputStreamReader + OutputStreamWriter 或 Files.newBufferedReader/newBufferedWriter,编码必须显式传入(如 StandardCharsets.UTF_8)。若忽略编码,会使用平台默认编码,跨系统易出乱码。
立即学习“Java免费学习笔记(深入)”;
- 不要用无参构造的
FileReader/FileWriter,它们不支持指定编码 - 建议用
Files.copy()配合StandardCopyOption.REPLACE_EXISTING处理简单场景,但它不支持编码转换 - 字符流拷贝本质仍是字节流+解码/编码,所以性能略低于纯字节流
示例代码(带 UTF-8 编码):
<font size="2"><pre class="brush:php;toolbar:false;">public static void copyByChars(Path src, Path dest) throws IOException {
try (Reader reader = Files.newBufferedReader(src, StandardCharsets.UTF_8);
Writer writer = Files.newBufferedWriter(dest, StandardCharsets.UTF_8)) {
char[] cbuf = new char[4096];
int len;
while ((len = reader.read(cbuf)) != -1) {
writer.write(cbuf, 0, len);
}
}
}
现代写法:用 Files.copy() 一行搞定(推荐初学者)
JDK 7+ 提供了 Files.copy(),底层已优化,支持字节流拷贝且自动处理资源。对普通文件复制足够简洁可靠。
- 适用于字节级复制,不涉及编码,所以适合所有文件类型
- 可传入
StandardCopyOption.REPLACE_EXISTING覆盖目标文件 - 不支持字符编码转换,也不支持进度监听等高级功能
示例:
<font size="2"><pre class="brush:php;toolbar:false;">try {
Files.copy(srcPath, destPath, StandardCopyOption.REPLACE_EXISTING);
} catch (FileAlreadyExistsException e) {
// 可选:提示用户或跳过
}
注意事项与避坑点
实际开发中容易忽略但影响稳定性的细节:
-
路径存在性检查:源文件不存在会抛
NoSuchFileException;目标目录不存在则写入失败,应提前用Files.createDirectories() - 大文件内存控制:缓冲区设为 4KB–64KB 即可,过大反而浪费堆内存,过小降低吞吐
-
符号链接处理:
Files.copy()默认复制链接指向的内容;若要复制链接本身,需用LinkOption.NOFOLLOW_LINKS -
权限与属性保留:标准流拷贝不保留文件权限、修改时间等元数据;如需保留,用
Files.copy()配合CopyingOption或 NIO 的Files.setAttribute()


















