在 C# WinForms 应用中，若**不使用数据库（如 SQL Server、SQLite 等）**，但仍需**持久化保存用户输入的数据（例如文本框内容、复选框状态、列表项等），并在程序重启后自动恢复**，最常用、轻量、安全且符合 .NET 生态的方案是： ✅ **使用序列化（Serialization）将数据保存到本地文件（如 JSON 或 XML）**，配合 `Application Settings`（用户设置）或自定义配置类 + `System.Text.Json`（推荐）/ `Newtonsoft.Json` / `XmlSerializer`。 下面以 **推荐的现代方式（.NET 5+ / .NET Core / .NET 6+）** 为例，使用 `System.Text.Json` 将用户数据序列化为 JSON 文件保存到 `AppData` 目录（安全、无需管理员权限、跨用户隔离），并实现启动时自动加载。 --- ### ✅ 推荐方案：自定义数据模型 + JSON 文件持久化（`%AppData%\YourApp\config.json`） #### 步骤概览： 1. 定义一个可序列化的数据模型类（如 `UserSettings`）； 2. 程序启动时（`Form.Load`）尝试从 JSON 文件反序列化加载； 3. 用户操作后（如点击“保存”按钮，或监听 `Form.Closing`）将当前状态序列化写入文件； 4. 使用 `Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData)` 获取安全存储路径。 --- ### 🧩 示例代码（完整可运行逻辑） 假设 WinForm 主窗体 `MainForm.cs` 中有： - `TextBox txtName` - `CheckBox chkRemember` - `NumericUpDown numAge` - `ListBox lstHobbies` 我们希望保存这 4 项，并在下次启动时还原。 #### 1️⃣ 定义数据模型（建议放在单独文件 `UserSettings.cs` 或 `MainForm` 内部） ```csharp // 可放在 MainForm 类内部，或独立文件 public class UserSettings { public string Name { get; set; } = ""; public bool RememberMe { get; set; } = false; public int Age { get; set; } = 0; public List<string> Hobbies { get; set; } = new List<string>(); } ``` #### 2️⃣ 在 `MainForm` 中添加保存/加载逻辑 ```csharp using System; using System.Collections.Generic; using System.IO; using System.Text.Json; using System.Windows.Forms; public partial class MainForm : Form { private readonly string _configPath; private UserSettings _settings = new UserSettings(); public MainForm() { InitializeComponent(); // ✅ 构建安全配置路径：C:\Users\<User>\AppData\Roaming\YourCompany\YourApp\config.json string appDataPath = Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData); _configPath = Path.Combine(appDataPath, "YourCompany", "YourApp", "config.json"); // ✅ 启动时尝试加载 LoadSettings(); } private void LoadSettings() { try { if (File.Exists(_configPath)) { string json = File.ReadAllText(_configPath); _settings = JsonSerializer.Deserialize<UserSettings>(json) ?? new UserSettings(); // ✅ 还原 UI 控件状态 txtName.Text = _settings.Name; chkRemember.Checked = _settings.RememberMe; numAge.Value = Math.Max(numAge.Minimum, Math.Min(numAge.Maximum, _settings.Age)); lstHobbies.Items.Clear(); foreach (string hobby in _settings.Hobbies) lstHobbies.Items.Add(hobby); } } catch (Exception ex) { MessageBox.Show($"加载配置失败：{ex.Message}", "警告", MessageBoxButtons.OK, MessageBoxIcon.Warning); // 失败时仍保持默认 _settings（空值），不影响启动 } } private void SaveSettings() { try { // ✅ 准备要保存的数据 _settings.Name = txtName.Text.Trim(); _settings.RememberMe = chkRemember.Checked; _settings.Age = (int)numAge.Value; _settings.Hobbies = new List<string>(); foreach (var item in lstHobbies.Items) _settings.Hobbies.Add(item.ToString()); // ✅ 确保目录存在 Directory.CreateDirectory(Path.GetDirectoryName(_configPath)); // ✅ 序列化并保存（带缩进便于调试，生产环境可省略） string json = JsonSerializer.Serialize(_settings, new JsonSerializerOptions { WriteIndented = true }); File.WriteAllText(_configPath, json); } catch (Exception ex) { MessageBox.Show($"保存配置失败：{ex.Message}", "错误", MessageBoxButtons.OK, MessageBoxIcon.Error); } } // ✅ 绑定到窗体关闭事件（推荐：确保退出前保存） private void MainForm_FormClosing(object sender, FormClosingEventArgs e) { SaveSettings(); } // ✅ （可选）绑定到“保存”按钮 private void btnSave_Click(object sender, EventArgs e) { SaveSettings(); MessageBox.Show("设置已保存！", "提示", MessageBoxButtons.OK, MessageBoxIcon.Information); } } ``` > 🔑 关键点说明： > - 使用 `ApplicationData` 路径：**免权限、用户隔离、符合 Windows 最佳实践**（比 `Program Files` 或 `exe` 同目录安全得多）； > - `JsonSerializer` 是 .NET Core 3.0+ 内置高性能 JSON 库，无需 NuGet（除非你用的是旧版 .NET Framework —— 见下方兼容说明）； > - `FormClosing` 事件中保存：避免用户意外关闭丢失数据； > - 异常捕获：防止因磁盘满、权限不足等导致崩溃； > - `WriteIndented = true` 仅用于调试；发布时可设为 `false` 提升性能/减小体积。 --- ### ⚙️ 兼容旧版 .NET Framework（如 .NET 4.7.2）？ 若你使用的是传统 .NET Framework（非 .NET Core/5+），`System.Text.Json` 不可用，则改用： ✅ **方案 A（推荐）：安装 `Newtonsoft.Json`（Json.NET）NuGet 包** ```bash Install-Package Newtonsoft.Json ``` 替换序列化部分为： ```csharp // 保存 string json = JsonConvert.SerializeObject(_settings, Formatting.Indented); File.WriteAllText(_configPath, json); // 加载 _settings = JsonConvert.DeserializeObject<UserSettings>(json) ?? new UserSettings(); ``` ✅ **方案 B：使用 `XmlSerializer`（无需额外包，但 XML 冗长）** （不推荐，仅作备选） ✅ **方案 C：使用 .NET 内置 `Properties.Settings.Default`（适合简单键值，不推荐复杂对象）** → 仅适用于少量标量（string/int/bool），且类型必须是可序列化且支持 Settings Designer 的类型；**不支持 `List<T>` 等集合直接存，需手动转换**，灵活性差，此处不展开。 --- ### 📌 其他轻量替代方案对比（简表） | 方案 | 优点 | 缺点 | 适用场景 | |------|------|------|-----------| | **JSON 文件（本例）** | 简洁、易读、跨平台、.NET 原生支持、支持任意对象结构 | 需自行管理路径/异常 | ✅ **绝大多数 WinForms 桌面应用首选** | | `Properties.Settings.Default` | 可视化设计、自动绑定、支持用户/应用级作用域 | 不支持复杂类型（如 `List<T>`）、难以调试、版本升级易丢数据 | 少量开关/字符串配置 | | 注册表（Registry） | 系统级集成 | 权限敏感、不易备份、跨平台无、Windows-only | ❌ 已不推荐（尤其 UAC 严格环境下） | | INI 文件（`WritePrivateProfileString`） | 兼容老程序 | .NET 无原生支持、需 P/Invoke、线程不安全 | ❌ 过时，不推荐新项目 | | 二进制序列化（`BinaryFormatter`） | 体积小、速度快 | **严重安全风险（已被 .NET 5+ 标记为过时且禁用）** | ❌ 绝对禁止使用！ | --- ### ✅ 补充建议（提升健壮性） - ✅ 添加「备份机制」：每次保存前复制旧文件为 `config.json.bak`； - ✅ 支持「重置设置」：提供按钮删除 `_configPath` 并重载默认； - ✅ 多语言支持？JSON 本身 UTF-8，天然支持中文等； - ✅ 敏感信息（如密码）？❌ **切勿明文存 JSON！** 应用加密（如 `ProtectedData` API）或交由系统凭据管理器（`Credential Vault`）。 ---