萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> 程式語言綜合

Java 實作讀取與刪除資料夾下所有檔案的完整指南

前言

在 Java 開發中,操作檔案系統是常見需求。特別是需要遞迴讀取或刪除整個資料夾樹時,許多開發者容易踩坑。本文將詳細解析如何正確實作資料夾的遞迴讀取與刪除,並提供生產級的程式碼範例。

核心概念:File.delete() 的限制

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)
  • 使用增強型 for 迴圈簡化程式碼

範例二:遞迴刪除資料夾及其所有內容

這是經典的「後序走訪」應用:先處理子節點,最後處理根節點。

/**
 * 遞迴刪除資料夾及其所有子檔案、子目錄
 * @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 (NIO.2) 更優雅的寫法

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,程式碼更簡潔、錯誤處理更完善、效能也更好。理解遞迴刪除的「後序走訪」本質,有助於舉一反三解決類似的樹狀結構操作問題。

copyright © 萬盛學電腦網 all rights reserved