新建WinForms项目应使用VS 2022的Windows Forms App (.NET)模板，目标框架选.NET 6+；避免选.NET Framework、命名含空格/中文、手动修改Designer.cs；UI更新须用InvokeRequired+Invoke；发布前切Release并移除调试钩子，用dotnet publish打独立包。
Visual Studio里新建WinForms项目就对了
别折腾命令行或手动写Program.cs和Form1.cs——VS 2022（含Community版）自带模板，选Windows Forms App (.NET)，目标框架建议.NET 6或更新，别选.NET Framework版本，否则后续引用NuGet包、跨平台部署会卡住。
常见错误：新建时误选Windows Forms App (.NET Framework)，结果发现Microsoft.Extensions.DependencyInjection加不进去，或者async/await在UI线程行为异常。这不是你代码问题，是运行时底座不一致。
- 项目名别带空格或中文，比如
My App或订单系统，会导致生成的命名空间出错、设计器打不开 - 勾选
Do not use top-level statements（如果VS提示），避免Program.cs里光秃秃一个Application.Run(new Form1());，后续加日志、配置初始化会难插手 - 创建后立刻检查解决方案资源管理器里有没有
Form1.cs [Design]这个节点——没有？多半是项目SDK类型错了，删掉重来
拖拽控件后，双击按钮进的是button1_Click事件处理函数
设计器不是画图工具，它本质是在生成Form1.Designer.cs里的初始化代码。你拖一个Button，VS自动给你加this.button1 = new System.Windows.Forms.Button();和this.Controls.Add(this.button1);——这些你不用改，也不该手动改。
真正要写的逻辑，全在Form1.cs里对应的方法里。比如双击按钮，光标直接跳到private void button1_Click(object sender, EventArgs e)里。
- 别在
Form1.Designer.cs里写业务逻辑，一保存设计器就可能覆盖掉 - 控件名别留默认的
button1、label2，右键属性面板改Name（如loginButton），不然三个月后自己都看不懂button3_Click到底是干啥的 - 事件名可以改，但签名必须保持
object sender, EventArgs e，改成string s会编译报错：No overload for 'xxx' matches delegate 'System.EventHandler'
InvokeRequired和BeginInvoke不是可选项，是必答题
WinForms控件不是线程安全的。从后台线程（比如Task.Run、Timer.Elapsed）直接改label1.Text = "done"，大概率不报错但UI卡死，或者某次运行突然抛InvalidOperationException: Cross-thread operation not valid。
这不是“偶尔出问题”，而是“只要线程不对就必然危险”。别信“我本地跑十次都没事”——它只是没崩在你眼前。
- 判断是否需要切换线程：用
if (label1.InvokeRequired)，不是if (Thread.CurrentThread != uiThread)（后者不可靠） - 安全写法是：
label1.Invoke((MethodInvoker)(() => label1.Text = "ok"));，别用BeginInvoke除非你真需要异步且不关心执行时机 - 如果整个方法都要更新UI，把核心逻辑抽成私有方法，再用
Invoke调它，别堆一堆labelX.Invoke(...)
发布前记得关掉Debug配置下的调试钩子
WinForms程序打包后双击闪退？或者在别人电脑上点按钮没反应？八成是代码里还留着Debugger.Launch()、Debug.Assert或#if DEBUG块里调了MessageBox.Show——这些在Release模式下要么被剔除，要么因缺少调试器直接卡住进程。
更隐蔽的是第三方库的日志组件（比如Serilog + Windows Debug sink），在Release包里尝试连DbgView也会挂起主线程。
- 发布前切到
Release配置，手动运行一次，开任务管理器看进程是否存在、CPU是否空转 - 用
dotnet publish -c Release -r win-x64 --self-contained true打独立包，别依赖用户装.NET Runtime（尤其Win7/Win10 LTSC） - 如果用了
App.config，确认startup节里没写useLegacyJit="true"之类已废弃的配置，.NET 6+会静默忽略并可能影响启动速度
最常被忽略的一点：窗体Load事件里做耗时操作（比如读大文件、连数据库），没加await也没放后台线程，结果窗体空白几秒才出现——用户以为程序坏了，其实只是你在Form1_Load里同步阻塞了UI线程。
