Java Swing 實現文件批量重命名工具：支持模板、編號與預覽

項目背景與需求分析

Windows 原生僅支持單個文件重命名，批量重命名需借助第三方工具或腳本。本文實現一個基於 Swing 的圖形化批量重命名工具，核心功能包括：

• 圖形界面選擇目標文件夾
• 自定義命名模板（支持 # 號位符表示流水號）
• 指定文件擴展名過濾
• 可設置起始編號
• 表格預覽新舊文件名對照
• 一鍵執行重命名並記錄結果

界面設計與佈局

採用 GridBagLayout 實現靈活佈局，主要組件：

核心業務邏輯實現

1. 文件過濾器

private static class ExtNameFileFilter implements FileFilter {
    private final String extName;
    
    public ExtNameFileFilter(String extName) {
        this.extName = extName.toLowerCase();
        if (!this.extName.startsWith(".")) this.extName = "." + this.extName;
    }
    
    @Override
    public boolean accept(File pathname) {
        return pathname.getName().toLowerCase().endsWith(extName);
    }
}

2. 瀏覽按鈕事件處理

protected void do_button_actionPerformed(ActionEvent e) {
    JFileChooser chooser = new JFileChooser();
    chooser.setFileSelectionMode(JFileChooser.DIRECTORIES_ONLY);
    chooser.setDialogTitle("選擇包含目標文件的文件夾");
    
    if (chooser.showOpenDialog(this) == JFileChooser.APPROVE_OPTION) {
        dir = chooser.getSelectedFile();
        forderField.setText(dir.getAbsolutePath());
    }
}

3. 核心重命名算法

protected void do_startButton_actionPerformed(ActionEvent e) {
    String templet = templetField.getText().trim();
    if (templet.isEmpty()) {
        JOptionPane.showMessageDialog(this, "請輸入重命名模板", "提示", JOptionPane.WARNING_MESSAGE);
        return;
    }
    
    // 解析模板中的 # 號位符
    int hashIndex = templet.indexOf('#');
    if (hashIndex == -1) {
        JOptionPane.showMessageDialog(this, "模板必須包含至少一個 # 號作為編號位符", "錯誤", JOptionPane.ERROR_MESSAGE);
        return;
    }
    
    String placeholder = templet.substring(hashIndex); // 如 "###"
    String formatPattern = templet.replace(placeholder, "%0" + placeholder.length() + "d"); // "photo%03d"
    
    // 處理擴展名
    String ext = extNameField.getText().trim().toLowerCase();
    if (!ext.isEmpty() && !ext.startsWith(".")) ext = "." + ext;
    
    // 獲取文件列表
    File[] files = dir.listFiles(new ExtNameFileFilter(ext));
    if (files == null || files.length == 0) {
        JOptionPane.showMessageDialog(this, "未找到匹配的文件", "提示", JOptionPane.INFORMATION_MESSAGE);
        return;
    }
    
    // 表格模型準備
    DefaultTableModel model = (DefaultTableModel) table.getModel();
    model.setRowCount(0);
    
    int counter = (Integer) startSpinner.getValue();
    
    // 執行重命名
    for (File file : files) {
        String newName = String.format(formatPattern, counter++) + ext;
        model.addRow(new Object[]{file.getName(), newName});
        
        File newFile = new File(file.getParent(), newName);
        boolean success = file.renameTo(newFile);
        if (!success) {
            System.err.println("重命名失敗: " + file.getName() + " -> " + newName);
        }
    }
    
    JOptionPane.showMessageDialog(this, "完成！共處理 " + files.length + " 個文件", "完成", JOptionPane.INFORMATION_MESSAGE);
}

進階功能擴展建議

1. 支持保留原文件名部分

模板中引入 * 符號代表原文件名（不含擴展名）：

// 模板 "backup_*_###" -> 文件 "photo.jpg" -> "backup_photo_001.jpg"
String template = templetField.getText();
if (template.contains("*")) {
    String baseName = FilenameUtils.getBaseName(file.getName());
    template = template.replace("*", baseName);
}

2. 添加撤銷功能

// 記錄重命名操作歷史
List history = new ArrayList<>();

class RenameRecord {
    File original;
    File renamed;
    long timestamp;
}

// 撤銷方法
public void undoLast() {
    if (!history.isEmpty()) {
        RenameRecord last = history.remove(history.size() - 1);
        last.renamed.renameTo(last.original);
        refreshTable();
    }
}

3. 異步處理大量文件

// 使用 SwingWorker 避免界面凍結
new SwingWorker() {
    @Override
    protected Void doInBackground() {
        for (File file : files) {
            // 重命名邏輯...
            publish(new FileRenameResult(oldName, newName, success));
        }
        return null;
    }
    
    @Override
    protected void process(List chunks) {
        // 更新表格和進度條
    }
    
    @Override
    protected void done() {
        // 完成提示
    }
}.execute();

常見問題排查

總結

本工具展示了 Swing 構建實用桌面應用的完整流程：界面佈局、文件操作、字符串模板解析、表格數據綁定。核心重命名邏輯利用 String.format 處理編號格式化，配合 File.renameTo 實現原子重命名。生產級應用可進一步加入異步處理、撤銷機制、日誌記錄等健壯性功能。