必须选Windows Forms App（.NET版本）模板，因其支持.NET 8+新特性及VS 2022/2026现代设计器；选错.NET Framework模板会导致设计器失效、InitializeComponent报错、事件无法自动生成等问题。
直接说结论：用 Visual Studio 创建 WinForm 项目，必须选 Windows Forms App 模板（.NET 版本），而不是 Windows Forms App (.NET Framework) —— 后者已过时，不支持 .NET 8+ 新特性，且设计器在 VS 2022/2026 中默认禁用。
创建项目时选错模板会卡在哪
很多人点开“创建新项目”后看到两个相似模板，随手选了带 (.NET Framework) 的，结果后续遇到：设计器打不开、InitializeComponent() 报红、双击控件不自动生成事件处理方法、甚至 Application.Run(new Form1()) 编译失败。
- 根本原因是：
.NET Framework项目依赖旧版 Windows Forms 设计器（基于 Windows SDK 7.0–10.0），而 VS 2022 起默认只启用面向.NET 5+的跨平台设计器 -
Windows Forms App（无后缀）模板对应的是.NET 6/8/10，使用现代 MSBuild SDK 风格项目文件（.csproj内含<TargetFramework>net8.0-windows</TargetFramework>） - 若强行打开
.NET Framework项目，工具箱可能为空，属性窗口不响应控件点击，Form1.Designer.cs中的this.AutoScaleMode = AutoScaleMode.Font;也可能被标黄警告
新建项目后，Form1.Designer.cs 里没生成 InitializeComponent() 怎么办
这是新手最常懵的一步：拖完控件，保存，编译，却提示 The name 'InitializeComponent' does not exist in the current context。
- 检查
Form1.cs是否为 partial class：顶部必须有public partial class Form1 : Form，且Form1.Designer.cs文件必须存在并被正确包含在项目中（右键文件 → “包含在项目中”） - 确认
Form1.Designer.cs文件的“生成操作”属性是Compile（右键文件 → 属性 → 生成操作）；如果是None或Content，VS 就不会把它编译进程序集 - 不要手动删掉
Form1.Designer.cs里的partial关键字或改类名——设计器靠这个和Form1.cs合并成一个完整类 - 如果 Designer.cs 文件内容为空，尝试在设计器界面右键窗体 → “运行自定义工具”，强制重新生成代码
双击按钮没自动跳转到 Click 事件，或事件名不对
比如你把按钮 Name 改成 btnSubmit，但双击后生成的方法却是 button1_Click，或者根本没反应。
- 确保你在设计器中选中了该按钮（边框高亮），再双击——不是在代码页、也不是在解决方案资源管理器里双击
- 检查属性窗口中“事件”视图（闪电图标）下的
Click属性值是否为空；如果已有值（如button1_Click），先清空再回车，VS 才会新建一个匹配当前Name的方法 - 方法签名必须严格匹配：
private void btnSubmit_Click(object sender, EventArgs e)；少个参数、类型写成System.EventArgs（带命名空间）都可能导致设计器无法关联 - 如果项目是 .NET 版本但用了
System.Windows.Forms的旧式引用方式（如手动添加了System.Drawing.dll引用），可能干扰事件绑定逻辑
真正容易被忽略的点是：WinForms 在 .NET 8+ 中默认启用 SingleFile 发布模式，但设计器生成的资源（如 .resx）不会自动打包进单文件——调试时一切正常，发布后图片丢失、本地化文本消失。需要手动在 .csproj 中加 <PublishTrimmed>false</PublishTrimmed> 并确认 <IncludeAllContentForSelfExtract>true</IncludeAllContentForSelfExtract>。
