DockPanelSuite是WinForm实现VS级停靠功能最成熟方案，需用DockPanel作主容器、DockContent继承子窗体、SaveAsXml/LoadFromXml持久化布局，注意DPI适配与类型序列化兼容性。
WinForm窗体停靠用 DockPanelSuite 最现实
原生 winform 没有真正意义上的“可拖拽停靠+浮动+自动布局”能力，硬靠 dock 属性只能做静态停靠，vs 那种体验根本做不到。想接近，dockpanelsuite 是目前最成熟、维护还在继续、文档虽旧但能跑的方案——别折腾自己写 dockmanager。
常见错误现象：Panel 设置 Dock = Fill 后一拉就变形、标签页关不掉、停靠方向错乱、重启后布局丢失；本质是 WinForm 缺少状态持久化和区域约束机制。
-
DockPanelSuite是第三方控件库（MIT 协议），NuGet 安装包名就是DockPanelSuite，不是WeifenLuo.WinFormsUI.Docking（那是旧版命名空间） - 主容器必须是
DockPanel控件，不能套在Panel或SplitContainer里再试图“模拟” - 每个子窗体（
DockContent）要继承自它，而不是普通Form；否则无法响应停靠事件或保存布局 - 布局保存靠
DockPanel.SaveAsXml()+LoadFromXml()，路径别写死在C:\，建议用Environment.GetFolderPath(Environment.SpecialFolder.ApplicationData)
DockContent 和普通 Form 的关键区别在哪
你不能把一个已存在的 Form 直接 Show() 到 DockPanel 里——它会弹出独立窗口，完全脱离停靠系统。必须让 UI 容器本身成为 DockContent 的子类。
使用场景：工具窗口（属性面板、输出窗口）、文档页（代码编辑器 Tab）、实时预览窗（右侧缩略图）都得走这条路。
- 新建类继承
DockContent，不是Form；构造函数里调用InitializeComponent()，然后手动加控件或拖设计器 -
Show(dockPanel)才能进停靠系统；Show()或ShowDialog()会跳出系统 -
Text属性决定标签页标题；Icon决定标签页图标；CloseButton控制右上角 × 是否显示 - 如果需要响应停靠位置变化，订阅
ContentChanged或重写OnDockStateChanged()，别监听Location或Size
停靠方向冲突时 DockState 怎么选
DockState 不是“我想停哪儿就设哪儿”，而是“当前实际停靠状态”。强行赋值 DockState.DockLeft 可能被忽略，尤其当目标区域已有内容且未设置 AllowEndUserDocking = true。
参数差异直接影响用户操作自由度：
-
DockState.Document：类似 VS 的编辑区，支持多文档标签页，但不支持拖出浮动；适合主工作区 -
DockState.DockLeft/Right/Top/Bottom：停靠到边缘，宽度/高度由用户拖动决定；需确保父DockPanel已启用AllowEndUserDocking = true -
DockState.Float：独立窗口，大小位置可自由拉；但关闭后默认不自动恢复停靠，得自己处理FormClosed事件并重置DockState -
DockState.AutoHide：滑出式侧边栏（如 VS 的解决方案资源管理器），依赖DockPanel.Theme设置，Win10+ 效果才自然
布局保存失败或加载错乱的三个硬坑
很多人调通了停靠，却卡在“重启后全乱了”——不是代码问题，是序列化和上下文没对齐。
性能影响不大，但兼容性极敏感：.NET Framework 4.7.2+ 和 .NET 6+ 的 XmlSerializer 行为略有差异，同一份 XML 在不同运行时可能加载失败。
- 保存前务必调用
dockPanel.SuspendLayout()，加载后调ResumeLayout(true)，否则控件尺寸计算异常 - XML 文件里存的是类型全名（含程序集版本），换机器或升级 NuGet 包后若程序集签名变了，
LoadFromXml()会静默失败；建议用LoadFromXml(stream, new Type[] { typeof(MyToolWindow) })显式传入类型数组 - 如果某个
DockContent类型在加载时不存在（比如插件式架构中该模块没加载），整个 XML 加载中断；得提前注册AppDomain.CurrentDomain.AssemblyResolve或捕获XmlSerializer.Deserialize异常做降级处理
最麻烦的其实是 DPI 缩放：高分屏下 DockPanel 保存的坐标是物理像素，加载时若进程没声明 dpiAware=true，布局会整体偏移。这个点，连官方示例都没彻底解决。
