在 C# WinForms 中，**选择文件夹（而非文件）** 的标准方式是使用 `FolderBrowserDialog` 类 —— 这是 .NET Framework 和 .NET Core/.NET 5+（Windows 平台）原生支持的、轻量且符合 Windows UI 规范的对话框。 > ✅ 注意：`OpenFileDialog` / `SaveFileDialog` 仅用于**文件**；选文件夹必须用 `FolderBrowserDialog`（或第三方/现代替代方案如 `IFileOpenPicker`（UWP）、`Windows Forms FolderBrowserDialog` 的增强版等）。 --- ### ✅ 推荐方案：使用 `FolderBrowserDialog`（兼容 .NET Framework 4.0+ / .NET Core 3.1+ / .NET 5+ Windows） #### ✅ 基础用法（同步阻塞式调用） ```csharp private void btnSelectFolder_Click(object sender, EventArgs e) { using (FolderBrowserDialog dialog = new FolderBrowserDialog()) { // ✅ 可选：设置默认初始路径（若存在且有效） dialog.SelectedPath = @"C:\MyProjects"; // 或 Environment.GetFolderPath(Environment.SpecialFolder.MyDocuments) // ✅ 可选：设置对话框标题（更友好） dialog.Description = "请选择一个用于保存数据的文件夹："; // ✅ 可选：要求用户新建文件夹（显示“新建文件夹”按钮） dialog.ShowNewFolderButton = true; // ✅ 显示对话框，并检查用户是否点击了“确定” DialogResult result = dialog.ShowDialog(this); // this 指当前 Form，确保模态居中 if (result == DialogResult.OK && !string.IsNullOrWhiteSpace(dialog.SelectedPath)) { string selectedFolder = dialog.SelectedPath; MessageBox.Show($"已选择文件夹：{selectedFolder}", "成功", MessageBoxButtons.OK, MessageBoxIcon.Information); // ✅ 实际应用：赋值给 TextBox、更新路径变量、初始化 SaveFileDialog 初始目录等 textBoxFolderPath.Text = selectedFolder; } else { MessageBox.Show("未选择任何文件夹。", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); } } } ``` --- ### ⚠️ 重要注意事项 & 最佳实践 | 项目 | 说明 | ✅ 正确做法 | |------|------|-------------| | **`SelectedPath` 初始化** | 若设为不存在路径，对话框可能崩溃或行为异常 | ✅ 使用 `Directory.Exists()` 验证后再赋值：<br>`dialog.SelectedPath = Directory.Exists(lastPath) ? lastPath : Environment.GetFolderPath(Environment.SpecialFolder.Desktop);` | | **跨平台兼容性** | `FolderBrowserDialog` **仅支持 Windows**（.NET Core/.NET 5+ 在 Linux/macOS 下会抛 `PlatformNotSupportedException`） | ✅ 如需跨平台，请改用 [Ookii.Dialogs](https://github.com/ookii-dialogs/ookii-dialogs-winforms)（推荐）或自定义窗体 + `TreeView` | | **权限与访问控制** | 用户可能选择无读取权限的系统路径（如 `C:\Windows`），后续操作会失败 | ✅ 选择后立即尝试 `Directory.GetAccessControl(path)` 或 `Directory.EnumerateDirectories(path).FirstOrDefault()` 做轻量验证 | | **UI 线程安全** | 必须在 UI 线程调用 `ShowDialog()` | ✅ WinForms 默认满足；若在后台线程（如 `Task.Run`），需 `Invoke()` 回 UI 线程 | --- ### ✅ 进阶：带“验证回调”的增强版（防止用户选择无效路径） ```csharp private void btnSelectValidFolder_Click(object sender, EventArgs e) { using (FolderBrowserDialog dialog = new FolderBrowserDialog()) { dialog.Description = "请选择一个可写入的文件夹（将用于导出报告）："; dialog.ShowNewFolderButton = true; // 🌟 关键：使用反射绕过 .NET Framework 限制（仅限 .NET Framework） // （注：.NET Core+ 不支持自定义验证回调，需手动二次校验） // → 所以我们采用“选择后验证”策略（更通用可靠） DialogResult result = dialog.ShowDialog(this); if (result == DialogResult.OK) { string path = dialog.SelectedPath; if (IsValidTargetFolder(path)) { textBoxOutputPath.Text = path; } else { MessageBox.Show($"所选路径不可用：\n- 不存在\n- 无写入权限\n- 是只读卷", "路径无效", MessageBoxButtons.OK, MessageBoxIcon.Warning); } } } } private bool IsValidTargetFolder(string path) { try { return Directory.Exists(path) && Directory.GetAccessControl(path).GetOwner(typeof(System.Security.Principal.NTAccount)) != null && File.GetAttributes(path).HasFlag(FileAttributes.ReadOnly) == false; // 更严谨可尝试创建/删除临时文件测试写权限 } catch { return false; } } ``` --- ### ✅ 替代方案（现代/跨平台/更美观） | 方案 | 适用场景 | 说明 | |------|----------|------| | **`Ookii.Dialogs.WinForms`**（NuGet: `Ookii.Dialogs.WinForms`） | ✅ 强烈推荐！替代原生 `FolderBrowserDialog`，支持 Windows 10/11 新式 UI、图标、多语言、`UseDescriptionForTitle` 等 | ```csharp<br>var dialog = new VistaFolderBrowserDialog();<br>dialog.Description = "选择项目根目录";<br>dialog.UseDescriptionForTitle = true;<br>if (dialog.ShowDialog() == DialogResult.OK)<br> path = dialog.SelectedPath;<br>``` | | **自定义 Folder Picker Form** | 需要完全定制 UI（如树形导航 + 预览 + 路径栏） | 使用 `TreeView` + `ListView` + `TextBox` 自建，重用 `System.IO.Directory` API | | **.NET MAUI / Avalonia** | 跨平台桌面应用 | 使用对应平台的 `FolderPicker`（如 MAUI 的 `FilePicker.PickFolderAsync()`） | > 💡 提示：安装 Ookii.Dialogs（推荐）： > ```bash > dotnet add package Ookii.Dialogs.WinForms > ``` > 然后 using： > ```csharp > using Ookii.Dialogs.WinForms; > ``` --- ### 🧩 小技巧：记住上次选择路径（持久化） ```csharp // 使用 Application Settings（设计器中添加字符串 Setting：LastFolderPath） private void LoadLastFolder() { string lastPath = Properties.Settings.Default.LastFolderPath; if (!string.IsNullOrEmpty(lastPath) && Directory.Exists(lastPath)) folderBrowserDialog1.SelectedPath = lastPath; } private void SaveLastFolder(string path) { Properties.Settings.Default.LastFolderPath = path; Properties.Settings.Default.Save(); } // 在选择成功后调用： SaveLastFolder(selectedFolder); ``` ---