WinForm登录界面源码实战：无边框窗体、异步登录与安全记住密码

简介：这份 Winform QQ 登录界面源码面向具备 C# 与 .NET 基础的桌面应用开发者，尤其适合希望练习 Winform 控件布局、事件处理与界面仿真的初学者。项目以还原 QQ2013 登录窗口为目标，不依赖第三方控件，使用 Label、TextBox、PictureBox、Button 等内置组件完成账号密码输入、Logo 展示与登录触发，并通过背景图、边框和字体调整贴近原版视觉效果。压缩包共 129 个文件，约 1.37MB，其中 93 个 png 与 jpg、gif 图片构成登录界面素材，6 个 cs 文件承载窗体逻辑，resx、resources、csproj、sln 等组成可打开的 Visual Studio 工程，exe、dll、pdb、config 则便于直接运行和调试。已有 1352 人学习，读者可据此研究登录验证、密码字符隐藏、进度条模拟加载等实现，并借助完整目录结构快速定位界面资源与代码，适合作为 Winform 入门练习或课程设计参考。

1. 仿 IM 登录窗口：一份 WinForm 登录界面源码能省掉多少重复劳动

我手上过过的桌面项目，第一屏几乎都是登录窗：一个头像、两个输入框、一个按钮。看着十分钟能画完，真写起来，无边框拖拽、密码框水印、记住密码、异步请求不卡界面、高分屏下别错位，一样都躲不掉。这份 WinForm 登录界面源码就是照着这个场景攒的，窗体、控件、服务三块切得比较干净，能直接编译跑起来，登录接口留了可替换的位置。它适合两种人：刚学 WinForm、想找一个有完整交互链路的练手项目的同学；以及手上有个内部工具要补登录入口、又不愿意从零画控件的开发者。对照它改自己的业务，比对着控件文档一点点试要快得多。

2. 项目结构与技术栈：窗体、控件、服务如何分工

2.1 目录长什么样，每块归谁管

同类源码最常见的问题是所有逻辑都塞进Form1.cs，几百行混在一起，设计器文件一改就崩。这份源码按职责切了四个目录，看目录名基本能猜到改动应该落在哪个文件里。

这个切法值得照抄的原因在于改造成本：换后端只动AuthService.cs，换皮肤只动Controls，调布局只动Forms，三者互不牵连。我见过不少同学生把HttpClient直接 new 在按钮点击事件里，后面想加超时重试、想加日志，就只能去按钮事件里翻，翻到第三遍就想重写了。

Controls目录里的控件都继承自标准控件（Button、TextBox），而不是从UserControl从零拼。好处是Text、Enabled、TabIndex这些属性照旧能用，设计器里也能拖，改造时不用重新学一套属性名。

2.2 运行环境和工程配置

工程是标准的Windows 窗体应用（.NET Framework），TargetFrameworkVersion建议 4.6.2 及以上——async/await、HttpClient、ProtectedData这套东西在 4.0 上要么没有要么难用。Visual Studio 2019 或 2022 都能直接打开，不需要装任何 UI 第三方库，绘制全靠System.Drawing。

项目引用里要确认这几个：

• System.Net.Http：登录请求走HttpClient，比WebRequest好写也好超时。
• System.Configuration：读app.config里的接口地址。
• System.Security：ProtectedData加密本地保存的密码。
• System.Drawing：GDI+ 绘制圆角、自绘按钮。

如果用Newtonsoft.Json解析返回体，需要走 NuGet 引一下；不想引也行，DataContractJsonSerializer能顶，只是写法啰嗦一点。

配置文件这块，源码把可变项全抽出来了：

<configuration> <appSettings> <!-- 登录接口，部署时只改这一行 --> <add key="LoginUrl" value="https://127.0.0.1:5001/api/auth/login" /> <!-- 请求超时，单位秒；内网可以调小到 5 --> <add key="TimeoutSeconds" value="10" /> <!-- 是否允许「记住密码」勾选，某些合规场景要关掉 --> <add key="AllowRememberPassword" value="true" /> </appSettings> </configuration>

LoginUrl抽出来的好处很直接：交付给测试环境时不用重新编译，改个 config 就能连不同后端。TimeoutSeconds我一般不会低于 5，桌面端用户点了登录之后盯着按钮转圈，超过 10 秒就该给个明确失败了，别让他干等。

读取这层再包一个静态类，避免到处ConfigurationManager.AppSettings["xxx"]：

internal static class ApiConfig { // 配置缺失时给一个本地默认值，保证首次运行不会直接崩 public static string LoginUrl => ConfigurationManager.AppSettings["LoginUrl"] ?? "https://127.0.0.1:5001/api/auth/login"; public static int TimeoutSeconds => int.TryParse(ConfigurationManager.AppSettings["TimeoutSeconds"], out var s) ? s : 10; // 本地存储目录固定放在用户漫游目录下，卸载重装不丢配置 public static string StoreDir => Path.Combine( Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData), "LoginDemo"); }

int.TryParse那行是血泪经验：配置文件被人手改成"10s"这种带单位的写法，int.Parse会直接抛异常，而它发生在窗体构造阶段，用户看到的就是程序闪一下就没了。用TryParse加默认值，最差也就是超时时间回到 10 秒。

2.3 启动顺序与窗体初始化链路

入口在Program.cs，三段式是 WinForm 的标准写法，不要省：

[STAThread] // 单线程单元，剪贴板和部分 COM 组件依赖它 static void Main() { Application.EnableVisualStyles(); // 启用视觉样式，否则控件是 Win98 灰 Application.SetCompatibleTextRenderingDefault(false); // 兜底：任何没被 catch 的 UI 线程异常都落到这里，别让程序静默退出 Application.ThreadException += (s, e) => MessageBox.Show(e.Exception.Message, "程序出错"); Application.Run(new FormLogin()); }

窗体这边的初始化顺序，决定了后面很多坑会不会出现：

public FormLogin() { InitializeComponent(); // 设计器生成，控件树在这一步完成 ApplyWindowStyle(); // 无边框、圆角、阴影，依赖控件树已存在 BindEvents(); // 事件统一在这里挂，不散落在 Designer.cs LoadSavedAccount(); // 读上次登录过的账号，填充到输入框 }

BindEvents()这个做法值得保留。Visual Studio 双击控件自动生成的事件会写进FormLogin.Designer.cs，这个文件在分发源码、做版本合并时最容易被覆盖掉，表现就是「按钮点了没反应」。把这些挂载收拢到一个手写方法里，Designer 文件被覆盖了也不影响交互逻辑。

ApplyWindowStyle()里要设圆角和Region，必须放在InitializeComponent()之后，因为那时候控件的Width、Height才是设计值。构造函数里拿到的尺寸在某些情况下还是默认的 0，做完 Region 窗体就成了一条缝——这个坑后面第 5 章还会细说。

初始化的最后一步才读本地账号，顺序不能反：先读账号再BindEvents，会在文本框还没准备好时触发一次TextChanged。

3. 核心模块拆解：从按下鼠标到登录返回的完整链路

3.1 无边框窗体与自定义标题栏的拖拽

FormBorderStyle = None之后，系统标题栏没了，拖拽和最大化都得自己接。主流有两种写法，源码里都保留了，我建议按场景选。

第一种是自己算偏移量，逻辑直观，适合需要限制拖拽区域（比如只允许拖标题栏）的场景：

private Point _dragOffset; // 鼠标相对窗体左上角的偏移 private bool _dragging; private void headerPanel_MouseDown(object sender, MouseEventArgs e) { if (e.Button != MouseButtons.Left) return; _dragging = true; _dragOffset = e.Location; // 记录按下点在容器内的坐标 } private void headerPanel_MouseMove(object sender, MouseEventArgs e) { if (!_dragging) return; // 把容器内坐标换算成屏幕坐标，再减去偏移，得到窗体新位置 var screen = headerPanel.PointToScreen(e.Location); Location = new Point(screen.X - _dragOffset.X, screen.Y - _dragOffset.Y); } private void headerPanel_MouseUp(object sender, MouseEventArgs e) => _dragging = false;

PointToScreen这一步不能省，直接拿e.X、e.Y去减会得到「鼠标一按窗体就跳到屏幕左上角」的效果。另外_dragOffset记录的是按下点相对容器的位置，如果标题栏内部还有 Label、PictureBox，事件会被子控件吃掉，得给子控件也挂同一组事件，或者干脆在容器上用MouseDown的sender反查。

第二种是交给系统处理，借WM_NCLBUTTONDOWN伪装成点击标题栏：

[DllImport("user32.dll")] private static extern bool ReleaseCapture(); [DllImport("user32.dll")] private static extern IntPtr SendMessage(IntPtr hWnd, int msg, IntPtr wParam, IntPtr lParam); private const int WM_NCLBUTTONDOWN = 0xA1; private const int HTCAPTION = 0x2; private void headerPanel_MouseDown(object sender, MouseEventArgs e) { if (e.Button != MouseButtons.Left) return; ReleaseCapture(); // 释放鼠标捕获 SendMessage(Handle, WM_NCLBUTTONDOWN, (IntPtr)HTCAPTION, IntPtr.Zero); }

第二种在 150% 缩放的高分屏上更稳，因为它走的是系统消息循环，坐标换算由系统负责。副作用是双击标题栏会触发最大化，如果不想要这个行为，得在MaximizeBox = false之外再拦一层。

标题栏右侧的最小化、关闭按钮，源码里没走系统按钮，而是两个自绘的RoundButton，点击事件里分别调WindowState = FormWindowState.Minimized和Close()。关闭前记得判断是否有未完成的登录请求，否则用户点了关闭、请求回来还往已释放的控件上写文本，就是一次ObjectDisposedException。

3.2 输入框水印与账号历史下拉

标准TextBox没有 placeholder，源码包了个WatermarkTextBox，用「显示提示文本 + 切灰色」的方式模拟：

public class WatermarkTextBox : TextBox { public string Placeholder { get; set; } = ""; private bool _showingPlaceholder; protected override void OnCreateControl() { base.OnCreateControl(); if (string.IsNullOrEmpty(Text)) ShowPlaceholder(); } private void ShowPlaceholder() { _showingPlaceholder = true; Text = Placeholder; ForeColor = Color.FromArgb(160, 160, 160); } protected override void OnGotFocus(EventArgs e) { base.OnGotFocus(e); if (_showingPlaceholder) { Text = ""; _showingPlaceholder = false; ForeColor = Color.FromArgb(51, 51, 51); } } protected override void OnLostFocus(EventArgs e) { base.OnLostFocus(e); if (string.IsNullOrEmpty(Text)) ShowPlaceholder(); } }

OnCreateControl里判断一次很有必要，不然窗体一显示就是空白框，用户不知道这里该填什么。密码框还有一层额外处理：显示提示文本时必须把UseSystemPasswordChar关掉，否则提示语会变成一串圆点。

这个方案的局限是Text属性和提示语共用了同一块内存，取值前必须判断_showingPlaceholder，登录时txtPassword.Text拿到 "请输入密码" 去请求接口，就是我第一次跑这份源码时踩的坑。稳妥做法是暴露一个RealText属性，把判断收进控件内部。

账号输入框用的是ComboBox自绘下拉，而不是TextBox加ListBox。ComboBox自带历史下拉的键盘交互（上下键选中、回车确认），省掉一堆事件处理。历史记录存在%AppData%\LoginDemo\history.json，登录成功后追加，最多保留 5 条：

private void SaveAccountHistory(string account) { Directory.CreateDirectory(ApiConfig.StoreDir); // 目录可能还不存在 var file = Path.Combine(ApiConfig.StoreDir, "history.json"); var list = File.Exists(file) ? JsonConvert.DeserializeObject<List<string>>(File.ReadAllText(file)) ?? new List<string>() : new List<string>(); list.Remove(account); // 已存在就提到最前，避免重复 list.Insert(0, account); if (list.Count > 5) list = list.Take(5).ToList(); File.WriteAllText(file, JsonConvert.SerializeObject(list)); }

Remove再Insert(0, ...)这个顺序是常见做法，比直接Insert好，能保证常用账号始终在第一条。文件写入没做并发保护，单人使用没问题，如果要多实例运行，加个Mutex或者改成写临时文件再File.Replace。

3.3 登录按钮的状态机与异步请求

按钮从可点变成「登录中…」再变回来，这个状态切换如果散在多个方法里，很容易出现「请求失败了但按钮还在转」。源码把它收进一个方法：

private void SetBusy(bool busy) { btnLogin.Enabled = !busy; btnLogin.Text = busy ? "登录中..." : "登 录"; pbLoading.Visible = busy; // 转圈的 PictureBox loadingTimer.Enabled = busy; // 驱动帧切换的 Timer linkForgot.Enabled = !busy; // 忙的时候禁用其他入口 }

注意连「忘记密码」这类次要入口也一起禁用了。只禁用主按钮的话，用户能在请求飞行途中点进别的页面，回来时状态就乱了。

请求体走HttpClient，全程 async，不阻塞 UI 线程：

private async void btnLogin_Click(object sender, EventArgs e) { if (!ValidateInput()) return; // 空值、长度、格式校验，失败直接 return SetBusy(true); try { using (var http = new HttpClient { Timeout = TimeSpan.FromSeconds(ApiConfig.TimeoutSeconds) }) { var form = new FormUrlEncodedContent(new Dictionary<string, string> { ["account"] = txtAccount.Text.Trim(), ["password"] = txtPassword.RealText, // 注意不是 Text，避开提示语 ["client"] = "winform" }); var resp = await http.PostAsync(ApiConfig.LoginUrl, form); var body = await resp.Content.ReadAsStringAsync(); var result = JsonConvert.DeserializeObject<LoginResult>(body); if (result != null && result.Code == 0) { SaveAccountHistory(txtAccount.Text.Trim()); if (chkRemember.Checked) CredentialStore.Save(txtAccount.Text.Trim(), txtPassword.RealText); // 用 Hide 而不是 Close，主窗体关闭时再由它统一退出 Hide(); new FormMain(result.Token).ShowDialog(); Close(); } else { lblError.Text = result?.Message ?? "账号或密码不正确"; } } } catch (TaskCanceledException) { lblError.Text = "连接超时，请检查网络后重试"; // 超时和取消走同一个异常 } catch (HttpRequestException ex) { lblError.Text = "无法连接服务器：" + ex.Message; } finally { SetBusy(false); // 无论成败都要恢复按钮，这是最容易漏的一行 } }

几个参数单独说。Timeout设成从配置读，是为了让内网和外网用不同的值；FormUrlEncodedContent对应后端application/x-www-form-urlencoded，如果接口收 JSON，换成StringContent(json, Encoding.UTF8, "application/json")。async void只允许出现在事件处理器上，普通方法一律async Task，否则异常没法被try/catch之外的调用链感知。

Hide()之后ShowDialog()再Close()这个顺序，能避免主窗体弹出来时登录窗还在旁边闪一下。Hide之前记一下DialogResult也行，看主窗体那边怎么接收。

3.4 记住密码：别用明文，也别用固定密钥

勾了「记住密码」就必然要把密码落在本地，这一步怎么处理区分了「能交差」和「能上线」。源码用 Windows 自带的数据保护 API：

public static class CredentialStore { private static string FilePath => Path.Combine(ApiConfig.StoreDir, "credential.dat"); public static void Save(string account, string password) { Directory.CreateDirectory(ApiConfig.StoreDir); var plain = $"{account}\n{password}"; var cipher = ProtectedData.Protect( Encoding.UTF8.GetBytes(plain), null, // 附加熵，留空即可 DataProtectionScope.CurrentUser); // 只有当前 Windows 用户能解开 File.WriteAllText(FilePath, Convert.ToBase64String(cipher)); } public static (string account, string password) Load() { if (!File.Exists(FilePath)) return (null, null); try { var cipher = Convert.FromBase64String(File.ReadAllText(FilePath)); var plain = Encoding.UTF8.GetString( ProtectedData.Unprotect(cipher, null, DataProtectionScope.CurrentUser)); var parts = plain.Split('\n'); return (parts[0], parts.Length > 1 ? parts[1] : ""); } catch (CryptographicException) { File.Delete(FilePath); // 解密失败说明换了用户或文件损坏，直接丢弃 return (null, null); } } }

DataProtectionScope.CurrentUser意味着换一台电脑、换一个 Windows 账号都解不开，这是预期行为，不是 bug。catch (CryptographicException)里删文件的处理很重要，否则每次启动都会在同一个坏文件上失败一次、弹一次异常提示，用户除了删目录没有别的办法。

如果业务上需要在同一台机器的多个账号间共享，换成LocalMachine作用域——但这等于本机管理员都能解开，安全性下降一档，得自己权衡。

4. 视觉还原的细节：圆角、阴影与自绘控件

4.1 圆角窗体：Region 与分层窗口的取舍

FormBorderStyle = None的窗体默认是尖角矩形。要做圆角，最省事的是给Region赋值：

private void ApplyRoundRegion(Control c, int radius) { if (c.Width <= 0 || c.Height <= 0) return; // 尺寸未定就别算，否则 Region 变一条缝 using (var path = new GraphicsPath()) { // 四个角的弧线首尾相接，最后 CloseFigure 闭合，缺一个角就会漏白边 path.AddArc(0, 0, radius, radius, 180, 90); path.AddArc(c.Width - radius - 1, 0, radius, radius, 270, 90); path.AddArc(c.Width - radius - 1, c.Height - radius - 1, radius, radius, 0, 90); path.AddArc(0, c.Height - radius - 1, radius, radius, 90, 90); path.CloseFigure(); c.Region = new Region(path); } }

-1那个偏移量不是玄学。GraphicsPath的坐标按像素格边界算，宽 300 的控件画到 299 才是最后一列，不减 1 最右边和最下边会有一像素被裁掉。

Region的硬伤是没有抗锯齿，圆角边缘是锯齿状的。补救办法有两种：窗体底色和外层背景色接近，锯齿就不显眼；或者用分层窗口（UpdateLayeredWindow）自己画，能得到平滑边缘，代价是代码量翻几倍、在某些远程桌面环境下会黑屏。这个登录窗尺寸小、圆角半径只有 8px，前者够用。

调用时机也要注意，构造函数里调用时Width可能还是设计值，等到Load里再算一次，并在Resize时重算：

protected override void OnLoad(EventArgs e) { base.OnLoad(e); ApplyRoundRegion(this, 8); } protected override void OnResize(EventArgs e) { base.OnResize(e); ApplyRoundRegion(this, 8); // 窗体大小变了，Region 必须重算 }

4.2 阴影、淡入动画与头像圆角裁剪

无边框窗体的另一个问题是贴在桌面上没有立体感。一个CreateParams覆写就能拿到系统投影：

protected override CreateParams CreateParams { get { const int CS_DROPSHADOW = 0x00020000; var cp = base.CreateParams; cp.ClassStyle |= CS_DROPSHADOW; // 请求系统绘制窗口阴影 return cp; } }

这个标志在 Win10/11 上稳定生效，Win7 上要靠桌面合成开启，属于系统行为差异，不值得为它写兼容分支。想要更「照着设计稿来」的阴影，就得自己画一层半透明窗体垫在后面，代码量和维护成本都不划算。

淡入用Opacity配合Timer，登录窗出现时不至于硬邦邦地弹出来：

private void FadeIn() { Opacity = 0; var timer = new Timer { Interval = 15 }; timer.Tick += (s, e) => { Opacity += 0.08; if (Opacity < 1) return; Opacity = 1; timer.Stop(); timer.Dispose(); // Timer 不释放会一直占着消息循环 }; timer.Start(); }

Opacity一旦小于 1，窗体就会变成分层窗口，这时候Region和Opacity同时使用在某些显卡驱动上会出现边缘闪烁——我一般只在无边框且尺寸固定的窗体上用这个组合。timer.Dispose()那行容易漏，漏了之后每开一次登录窗就多一个存活对象。

头像的圆形裁剪是自己画的，PictureBox本身没有圆形模式：

public static Image MakeRoundAvatar(Image src, int size) { var bmp = new Bitmap(size, size); using (var g = Graphics.FromImage(bmp)) using (var path = new GraphicsPath()) { g.SmoothingMode = SmoothingMode.AntiAlias; // 抗锯齿，边缘才不毛糙 g.InterpolationMode = InterpolationMode.HighQualityBicubic; path.AddEllipse(0, 0, size - 1, size - 1); g.SetClip(path); g.DrawImage(src, new Rectangle(0, 0, size, size)); } return bmp; }

size - 1同样的道理，DrawImage画到size-1才填满。源图不一定正方形，DrawImage会自动拉伸变形，头像要不变形就得先按短边居中裁一次再缩放。

4.3 自绘按钮与高分屏适配

登录按钮是自绘的，因为系统按钮改颜色要跟FlatStyle、UseVisualStyleBackColor一大堆属性搏斗：

public class RoundButton : Button { public Color NormalColor { get; set; } = Color.FromArgb(0, 132, 255); public Color HoverColor { get; set; } = Color.FromArgb(24, 152, 255); public Color PressColor { get; set; } = Color.FromArgb(0, 110, 220); private int _state; // 0 常态 / 1 悬停 / 2 按下 protected override void OnMouseEnter(EventArgs e) { _state = 1; Invalidate(); base.OnMouseEnter(e); } protected override void OnMouseLeave(EventArgs e) { _state = 0; Invalidate(); base.OnMouseLeave(e); } protected override void OnMouseDown(MouseEventArgs e) { _state = 2; Invalidate(); base.OnMouseDown(e); } protected override void OnMouseUp(MouseEventArgs e) { _state = 1; Invalidate(); base.OnMouseUp(e); } protected override void OnPaint(PaintEventArgs e) { var g = e.Graphics; g.SmoothingMode = SmoothingMode.AntiAlias; var color = _state == 2 ? PressColor : _state == 1 ? HoverColor : NormalColor; if (!Enabled) color = Color.FromArgb(190, 190, 190); using (var path = RoundedRect(ClientRectangle, 4)) using (var brush = new SolidBrush(color)) g.FillPath(brush, path); TextRenderer.DrawText(g, Text, Font, ClientRectangle, ForeColor, TextFormatFlags.HorizontalCenter | TextFormatFlags.VerticalCenter); } }

三个细节。FlatStyle必须设成Flat且FlatAppearance.BorderSize = 0，否则系统会在自绘之上再刷一层边框，看起来像按钮「套了个圈」。文字用TextRenderer.DrawText而不是Graphics.DrawString，前者跟系统字体渲染一致，中文不发虚。Invalidate()只重绘脏区，别用Refresh()，那个会连带子控件一起重绘，鼠标快速划过时掉帧。

高分屏适配在.NET Framework项目里靠清单文件，不是靠代码：

<!-- app.manifest --> <application xmlns="urn:schemas-microsoft-com:asm.v3"> <windowsSettings> <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true/pm</dpiAware> <dpiAwareness xmlns="http://schemas.microsoft.com/SMI/2016/WindowsSettings">PerMonitorV2</dpiAwareness> </windowsSettings> </application>

清单里声明PerMonitorV2之后，窗体跨屏拖动会收到WM_DPICHANGED，这时候要重新调用一次ApplyRoundRegion和布局重算，否则从 100% 屏拖到 150% 屏，圆角还在但控件全部错位。图省事的做法是声明true/pm只做系统级缩放，接受一点模糊，换来的是一次都不用重算。

5. 避坑与常见问题排查：五种跑不起来的典型情况

5.1 编译和启动阶段的问题

现象：设计器打开FormLogin.cs报「找不到类型或命名空间」。原因是FormLogin.Designer.cs里的namespace或者类名被改过，和.cs里的分部类对不上。解决方式是看两边的namespace是否完全一致（大小写敏感），确认InitializeComponent()方法还在且没被注释掉。设计器只认这个约定的分部结构，改一个字母就打不开。

现象：编译能过，运行起来窗口一片白，控件全部不显示。多半是ApplyRoundRegion在构造函数里被调用，那一刻Width、Height还是设计值甚至 0，Region变成了一条缝，整个窗体被裁没了。解决办法是把 Region 的计算挪到OnLoad里，并且在方法开头加if (c.Width <= 0 || c.Height <= 0) return;兜底。

现象：点了登录按钮没反应，断点也不进。InitializeComponent()之后事件被覆盖了，或者BindEvents()忘了调。这类问题在设计器文件被别的分支合并过一次后特别常见。兜底手段是在btnLogin.Click里第一行加一句日志，能从日志确认事件到底有没有进来。

5.2 显示和交互阶段的问题

现象：窗体拖动时抖得厉害，或者鼠标一按窗口跳到屏幕左上角。原因是MouseMove里用了e.X、e.Y直接减，没有做PointToScreen换算，或者_dragOffset记录的是鼠标在窗体上的绝对位置而不是相对按下点的偏移。检查方式是把_dragOffset打到日志里看一眼，正常值应该在几十像素这个量级。

现象：勾了「记住密码」，换一台电脑登录时提示密码错误。ProtectedData.Protect用了DataProtectionScope.CurrentUser，密文绑定当前 Windows 用户，复制整个%AppData%目录过去也解不开。这不是 bug。如果确实需要跨机器共享，换LocalMachine作用域或者改成服务端下发的长期令牌，别自己在本地拼一个固定密钥——固定密钥写在源码里等于没加密。

现象：从 100% 显示器拖到 150% 显示器，控件全部错位、文字糊。清单文件里只写了dpiAware=true没写PerMonitorV2，或者写了但没处理WM_DPICHANGED。先确认清单被正确嵌进了 exe（用工具看 exe 的资源段），再确认窗体的AutoScaleMode设成了Dpi而不是None。

提示：这份源码里所有Timer、HttpClient、GraphicsPath都在using或显式Dispose里，改动时别图省事把它们提到字段上又不释放，长期运行会看到 GDI 句柄数量一直涨。

6. 二次开发：把这份登录窗改成自己系统的入口

改动量最小、收益最直接的一条路，是把AuthService抽成接口。现在登录逻辑直接在按钮事件里 newHttpClient，接第二套后端（比如内网 LDAP + 外网账号）时就得写if分支。我一般这么切：

public interface IAuthService { Task<LoginResult> LoginAsync(string account, string password, CancellationToken ct); } // 表单提交版 public class FormAuthService : IAuthService { public async Task<LoginResult> LoginAsync(string account, string password, CancellationToken ct) { using (var http = new HttpClient { Timeout = TimeSpan.FromSeconds(ApiConfig.TimeoutSeconds) }) { var form = new FormUrlEncodedContent(new Dictionary<string, string> { ["account"] = account, ["password"] = password }); var resp = await http.PostAsync(ApiConfig.LoginUrl, form, ct); var body = await resp.Content.ReadAsStringAsync(); return JsonConvert.DeserializeObject<LoginResult>(body); } } }

按钮事件里只留var result = await _auth.LoginAsync(...)，CancellationToken从窗体关闭时取消，这样用户点关闭会顺带掐掉在途请求，省掉一堆对象已释放的异常。

几个扩展点按投入产出比排：

验证方式别只靠手点。我在FormLogin上加了个隐藏的调试入口（Ctrl+Shift+D），能直接切到FormMain而不走网络，这样改布局的时候不用每次都起后端。上线前把这段用#if DEBUG包起来，别让它跟着发布版本出去。

界面还原这块有个反直觉的结论：圆角半径、按钮高度、字号这三个参数，不要一点点试，先按设计稿的数值直接设，跑起来再微调。我见过太多人凭感觉写radius = 10，结果跟设计稿差一截，来回改十几次。另外把窗体设成FixedSingle加MaximizeBox = false之外还要记得关掉AutoScaleMode的自动推断，不然在不同机器上字体缩放会让布局飘。

最后一条是我自己的习惯：每次改完登录相关代码，都强制走一遍「断网 → 点登录 → 等超时 → 恢复网络 → 再点登录」这条路径。这条路径能同时暴露Timeout配置、异常捕获、SetBusy(false)有没有写在finally里三个问题。我早期有次漏了finally里的恢复，用户网络抖一下就永久卡在「登录中…」，只能重启程序，那次之后这个流程就成了我交付前必走的一遍。希望这些能帮你少走两趟弯路。

本文还有配套的精品资源，点击获取