在 Java 開發中,操作檔案系統是常見需求。特別是需要遞迴讀取或刪除整個資料夾樹時,許多開發者容易踩坑。本文將詳細解析如何正確實作資料夾的遞迴讀取與刪除,並提供生產級的程式碼範例。
Java 的 File.delete() 方法僅能刪除「單一檔案」或「空目錄」。若目錄包含檔案或子目錄,直接呼叫會失敗並回傳 false。因此,刪除非空目錄必須採用遞迴演算法:先刪除所有子檔案與子目錄,最後再刪除目錄本身。
以下程式碼示範如何走訪指定路徑,列印所有檔案名稱(包含子目錄中的檔案):
package test.com;
import java.io.File;
import java.io.FileNotFoundException;
import java.io.IOException;
public class ReadFile {
/**
* 遞迴讀取資料夾下所有檔案
* @param filepath 目標路徑
* @return 是否成功
*/
public static boolean readfile(String filepath) throws FileNotFoundException, IOException {
File file = new File(filepath);
if (!file.exists()) {
throw new FileNotFoundException("路徑不存在:" + filepath);
}
if (!file.isDirectory()) {
// 是檔案,直接列印名稱
System.out.println(file.getName());
} else {
// 是目錄,遞迴處理每個子項目
String[] filelist = file.list();
if (filelist != null) {
for (String name : filelist) {
File child = new File(file, name); // 使用 File(File, String) 建構子避免路徑分隔符問題
if (child.isDirectory()) {
readfile(child.getAbsolutePath());
} else {
System.out.println(child.getName());
}
}
}
}
return true;
}
public static void main(String[] args) {
try {
// 測試路徑請依實際環境修改
readfile("C:/Users/SW/Desktop/SKJ_H25補正04_RCAG03_SKJ");
} catch (Exception e) {
e.printStackTrace();
}
System.out.println("ok");
}
}
new File(parent, child) 建構子自動處理路徑分隔符,跨平台相容性更好file.exists() 檢查,避免空指標異常file.list() 做 null 檢查(當目錄無讀取權限時會回傳 null)這是經典的「後序走訪」應用:先處理子節點,最後處理根節點。
/**
* 遞迴刪除資料夾及其所有子檔案、子目錄
* @param delpath 要刪除的路徑
* @return 是否全部刪除成功
*/
public static boolean deletefile(String delpath) {
File file = new File(delpath);
if (!file.exists()) {
System.out.println("路徑不存在,無需刪除:" + delpath);
return true; // 視為成功
}
if (file.isDirectory()) {
String[] filelist = file.list();
if (filelist != null) {
for (String name : filelist) {
File child = new File(file, name);
if (child.isDirectory()) {
deletefile(child.getAbsolutePath()); // 遞迴刪除子目錄
} else {
if (!child.delete()) {
System.err.println("刪除檔案失敗:" + child.getAbsolutePath());
return false;
}
}
}
}
}
// 最後刪除自己(空目錄或檔案)
if (!file.delete()) {
System.err.println("刪除目錄/檔案失敗:" + file.getAbsolutePath());
return false;
}
return true;
}
Java 7 引入的 java.nio.file.Files 提供了 walkFileTree 方法,配合 SimpleFileVisitor 可用更少程式碼完成相同功能,且支援符號連結、權限處理等進階特性:
import java.io.IOException;
import java.nio.file.*;
import java.nio.file.attribute.BasicFileAttributes;
public class ModernFileDeleter {
public static void deleteDirectory(Path path) throws IOException {
Files.walkFileTree(path, new SimpleFileVisitor() {
@Override
public FileVisitResult visitFile(Path file, BasicFileAttributes attrs) throws IOException {
Files.delete(file); // 刪除檔案
return FileVisitResult.CONTINUE;
}
@Override
public FileVisitResult postVisitDirectory(Path dir, IOException exc) throws IOException {
Files.delete(dir); // 刪除空目錄
return FileVisitResult.CONTINUE;
}
});
}
}
| 問題 | 解決方案 |
|---|---|
| 路徑分隔符硬編碼 | 使用 File.separator 或 Paths.get() |
| 刪除失敗無提示 | 檢查 delete() 回傳值,記錄失敗路徑 |
| 大量檔案導致堆疊溢位 | 改用 NIO.2 的 walkFileTree(內部用迭代而非遞迴) |
| 權限不足拋出例外 | 捕獲 SecurityException / AccessDeniedException 並記錄 |
傳統 java.io.File 配合遞迴足以應付簡單場景,但生產環境建議使用 NIO.2 API,程式碼更簡潔、錯誤處理更完善、效能也更好。理解遞迴刪除的「後序走訪」本質,有助於舉一反三解決類似的樹狀結構操作問題。