Java File 類操作檔案與目錄屬性完全指南：建立、刪除、遍歷、屬性查詢實戰

File 類核心定位

java.io.File 是檔案系統路徑的抽象表示，不代表實際資料內容。它封裝了檔案/目錄的建立、刪除、重命名、屬性查詢、目錄遍歷等操作，是 Java 檔案系統交互的入口類。

注意：File 物件建立不會觸發磁碟 I/O，僅在呼叫 createNewFile()、mkdir() 等方法時才與檔案系統互動。

核心構造方法

• new File(String pathname)：相對/絕對路徑字串
• new File(String parent, String child)：父路徑 + 子路徑
• new File(File parent, String child)：父 File 物件 + 子路徑
• new File(URI uri)：file:// 協定 URI

檔案/目錄屬性查詢 API 速查

建立與刪除操作

目錄遍歷與列表

File dir = new File("D:/myDoc");
if (dir.isDirectory()) {
    // 1. 列出所有子項 (字串陣列)
    String[] names = dir.list();
    
    // 2. 列出所有子項 (File 陣列，推薦)
    File[] files = dir.listFiles();
    
    // 3. 過濾器：只列 .txt 檔
    File[] txtFiles = dir.listFiles((d, name) -> name.endsWith(".txt"));
    
    // 4. 遞迴遍歷整棵樹
    listAll(dir, 0);
}

void listAll(File f, int depth) {
    System.out.println("  ".repeat(depth) + (f.isDirectory() ? "[D] " : "[F] ") + f.getName());
    if (f.isDirectory()) {
        File[] children = f.listFiles();
        if (children != null) for (File c : children) listAll(c, depth + 1);
    }
}

路徑處理實用技巧

• 路徑分隔符：File.separator (Windows `\`、Linux `/`)，File.pathSeparator (CLASSPATH 分隔符 `;` / `:`)。
• 相對轉絕對：file.getAbsoluteFile() 回傳絕對路徑的 File 物件。
• 父目錄：file.getParentFile() 取得父目錄 File 物件 (可能為 null)。
• 重命名/移動：file.renameTo(new File("newPath")) (跨分區可能失敗，建議用 NIO.2 Files.move)。

現代替代方案：NIO.2 (java.nio.file) - JDK 7+ 強烈推薦

完整實戰範例：檔案資訊查看器

import java.io.File;
import java.io.IOException;
import java.text.SimpleDateFormat;

public class FileInfoViewer {
    public static void main(String[] args) {
        File target = new File("D:/myDoc/test.txt");
        showInfo(target);
    }

    static void showInfo(File f) {
        if (!f.exists()) {
            System.out.println("路徑不存在：" + f.getAbsolutePath());
            return;
        }
        System.out.println("========== 檔案資訊 ==========");
        System.out.println("名稱：" + f.getName());
        System.out.println("絕對路徑：" + f.getAbsolutePath());
        try { System.out.println("規範路徑：" + f.getCanonicalPath()); } catch (IOException ignored) {}
        System.out.println("類型：" + (f.isDirectory() ? "目錄" : "檔案"));
        System.out.println("大小：" + readableSize(f.length()));
        System.out.println("最後修改：" + new SimpleDateFormat("yyyy-MM-dd HH:mm:ss").format(f.lastModified()));
        System.out.println("可讀/可寫/可執行：" + f.canRead() + "/" + f.canWrite() + "/" + f.canExecute());
        System.out.println("隱藏屬性：" + f.isHidden());
    }

    static String readableSize(long bytes) {
        if (bytes < 1024) return bytes + " B";
        int unit = 1024;
        if (bytes < unit * unit) return String.format("%.1f KB", bytes / (double)unit);
        if (bytes < unit * unit * unit) return String.format("%.1f MB", bytes / (double)(unit*unit));
        return String.format("%.1f GB", bytes / (double)(unit*unit*unit));
    }
}

總結

• File 適合簡單路徑操作、屬性查詢、小型工具。
• 生產級應用：優先使用 NIO.2 (Path/Files)，異常資訊豐富、功能完整、效能更佳。
• 路徑字串拼接務必用 File.separator 或 Paths.get() 保證跨平台相容。

1. 上一篇文章： Java FileWriter 寫入文字檔完整指南：緩衝、編碼與資源管理最佳實踐
2. 下一篇文章： Java Swing 應用程式自訂標題列圖示完整教學：Toolkit 與 ImageIcon 兩大方案

Java 程式設計入門

Java SE 6 GUI 革命：啟動畫面、系統托盤、對話框與 GIF 支援全面體驗

前言：Java GUI 的歷史轉折點 長期以來，AWT 與

Java SAX 解析 XML 完整指南：事件驅動機制、Handler 實戰與文檔還原技巧

前言 SAX (Simple API for XML) 是

Log4j2 完整實戰教程：從入門到生產級配置最佳實踐

Log4j2 核心優勢 無鎖異步日誌：基於 LMAX Di

Hibernate 延遲載入完整配置指南：一對一、一對多、多對一與自關聯

核心原則 延遲載入 (Lazy Loading) 透過代理物