Qt/C++ getOpenFileNames() 多選檔案操作指南

結論

QFileDialog::getOpenFileNames() **原生支援多選**。若只能單選，通常是操作方式或平台細節問題。

正確多選操作

• Windows / Linux (KDE/GNOME)： 在檔案對話框中 **按住 Ctrl 點選** 多個不連續檔案，或 **按住 Shift 點選首尾** 選取連續範圍。
• macOS： 同上，Cmd (⌘) 替代 Ctrl。

程式碼範例

QStringList files = QFileDialog::getOpenFileNames(
    this, 
    tr("選擇一或多個檔案"), 
    QDir::homePath(), 
    tr("圖片 (*.png *.jpg);;所有檔案 (*)")
);

if (!files.isEmpty()) {
    for (const QString &file : files) {
        qDebug() << "選中:" << file;
        // 處理每個檔案...
    }
}

常見誤區

1. 混淆 getOpenFileName() (單數) 與 getOpenFileNames() (複數)： 前者回傳 QString (單選)，後者回傳 QStringList (多選)。
2. 對話框模式： 若使用 QFileDialog 物件模式 (setFileMode(QFileDialog::ExistingFiles))，確認已呼叫 setOption(QFileDialog::DontUseNativeDialog, false) (預設使用原生對話框，支援多選)。強制非原生對話框 (DontUseNativeDialog=true) 時，Qt 內建對話框同樣支援 Ctrl/Shift 多選。
3. 靜態函數 vs 物件： 靜態函數 getOpenFileNames() 內部已正確設定 ExistingFiles 模式，無需額外配置。

驗證步驟

1. 建立最小測試專案，僅含一按鈕觸發上述程式碼。
2. 編譯執行，嘗試 Ctrl+點選多檔。
3. 若仍無法多選，檢查 Qt 版本 (5.15+ / 6.x 均支援)、作業系統檔案管理器是否正常多選。

簡言之：**按住 Ctrl (或 Cmd) 點選即可多選**，程式碼無誤即為操作問題。