WPF Application模板是创建现代.NET WPF应用的唯一推荐入口，选WPF Application (.NET Framework)会锁死在旧框架，无法使用.NET 10新特性、新控件（如改进的InkCanvas）和性能优化。

WPF Application 模板是创建现代 .NET WPF 桌面应用的唯一推荐入口，用 WPF Application (.NET Framework) 模板会直接锁死在旧框架，无法使用 .NET 10 新特性、新控件（如改进的 InkCanvas）和性能优化。

选错模板：为什么 WPF Application (.NET Framework) 不能碰

Visual Studio 2026 的模板列表里并列出现两个名称相近的选项，但底层差异巨大：

• WPF Application → 默认绑定 .NET 10.0 (LTS)，支持 Microsoft.NET.Sdk.Wpf SDK 风格项目格式，可直接引用 System.Windows.Controls.InkCanvas 等新命名空间下的类型
• WPF Application (.NET Framework) → 绑定 .NET Framework 4.8 或更老版本，项目文件仍是 csproj 传统格式，InkCanvas 类型位于 PresentationFramework.dll，但行为受限且无触控笔迹平滑插值
• 一旦选错，后续升级需手动重写项目文件、迁移 NuGet 引用、修复 XAML 命名空间前缀（比如从 xmlns:local="clr-namespace:..." 改为 SDK 风格自动解析），不值得

创建时必须确认的三个关键配置点

新建项目流程中，有三处容易跳过但决定后续开发顺畅度：

C#

"避开 C# 常见错误——空陷阱、异步陷阱、LINQ 陷阱及资源泄漏。"

下载

• 在 “搜索模板” 框输入 wpf 后，只认准图标旁标注 .NET（非 .NET Framework）的模板
• “配置新项目” 步骤中，Location 路径别用默认的 C:\Users\XXX\source\repos —— 若路径含中文或空格，某些 WPF 设计器组件加载失败，报错 XamlParseException
• “Additional information” 页面，Framework 下拉框必须手动选成 .NET 10.0 (Long-term support)；VS 有时默认回退到 .NET 8.0，会导致 InkCanvas.StylusPlugIns 等 API 不可用

MainWindow.xaml 设计器打不开？先检查这几点

生成项目后双击 MainWindow.xaml，如果只看到空白页或提示 “设计器不可用”，不是环境坏了，而是常见配置冲突：

• 确认已安装 .NET desktop development 工作负载 —— 单独装了 .NET 10 SDK 不够，必须勾选该工作负载，否则设计器缺少 WpfCoreDesigner 进程支持
• 关闭所有 devenv.exe 进程再重启 VS，设计器依赖的 Microsoft.VisualStudio.DesignTools.Xaml.LanguageService 服务常因热加载失败卡住
• 若仍报错，右键 MainWindow.xaml → “查看代码”，在 MainWindow 构造函数第一行加 InitializeComponent(); 手动调用（虽然模板本该自动生成，但偶尔漏写）

改窗口标题/尺寸/背景色，XAML 和属性面板哪个更可靠

初学者常纠结该用拖拽改属性还是手写 XAML。结论是：简单属性用属性面板快，但涉及命名空间或条件逻辑时必须写 XAML：

• 改标题：属性面板设 Title 属性，等效于在 Window 标签内加 Title="手写板" —— 两者完全一致，无差别
• 改尺寸：属性面板设 Width="370" Height="550" 安全；但若后续要响应式缩放，就得写 SizeToContent="WidthAndHeight" 或绑定 ActualWidth，这些只能进 XAML
• 改背景色：属性面板选 Brown 会生成 Background="Brown"；但若想用渐变或图片，必须手写 Background 内容，例如：

  <Window.Background>
      <LinearGradientBrush StartPoint="0,0" EndPoint="1,1">
          <GradientStop Color="Brown" Offset="0.0"/>
          <GradientStop Color="SaddleBrown" Offset="1.0"/>
      </LinearGradientBrush>
  </Window.Background>

WPF 开发里最易被忽略的其实是项目 SDK 类型 —— 它藏在 .csproj 文件第一行，决定了整个构建链路是否走现代 .NET 路线。哪怕只是加一个 InkCanvas 控件，没确认这点，后面所有事件绑定、样式继承、资源字典加载都可能无声失败。