WinDbg Preview双机调试设置：小白指南（图文并茂）

用WinDbg Preview搭双机调试环境？手把手带你从零搞定（新手友好版）

你有没有遇到过这样的情况：刚写完一个驱动，一加载系统就蓝屏；或者某个内核模块行为诡异，日志看不出问题。这时候，单靠打印和猜测已经无济于事——你需要的，是真正“看到”系统内部发生了什么。

这就是内核级调试的价值所在。而实现它的标准方式，就是双机调试（Host-Target Debugging）：一台电脑跑调试器（主机），另一台运行被调试系统（目标机）。这样即使目标机崩溃了，调试器依然在线，能完整捕获崩溃现场。

微软现在主推的工具是WinDbg Preview——它不是简单的界面翻新，而是基于现代技术栈重构的下一代调试平台。相比老版WinDbg那套陈旧的UI，Preview版本支持标签页、深色模式、自动符号下载，甚至还能装插件，体验完全不一样。

今天我们就来一步步教你如何用WinDbg Preview搭建一套可用的双机调试环境，涵盖最常用的两种连接方式：串口和网络调试。全程图文并茂，哪怕你是第一次接触内核调试，也能照着做出来。

先搞清楚：为什么非得双机？

你可能会问：“我能不能直接在本机调试？”
答案是：不能，至少对内核来说不行。

因为当你调试的是操作系统本身或驱动程序时，一旦触发异常（比如访问非法内存地址），整个系统都会挂掉——包括你在上面运行的调试器。换句话说，“尸体”和“法医”一起没了。

所以必须把调试器放在另一台机器上。当目标机出事时，主机上的 WinDbg 还活着，可以立即查看寄存器状态、调用栈、内存内容，帮你精准定位问题根源。

这个过程依赖 Windows 内建的Kernel Debugger (KD)协议，通过物理或虚拟通道将调试信息传输出去。只要连接建立起来，你就能像操作本地程序一样深入分析内核行为。

准备工作：软件与硬件

主机（Host）

• 安装WinDbg Preview
• 推荐从 Microsoft Store 下载（搜索 “WinDbg Preview”）
• 或安装 WDK（Windows Driver Kit），其中包含调试工具包
• 确保系统为 64 位 Windows 10/11

目标机（Target）

• 可以是物理机，也可以是虚拟机（VMware、Hyper-V、VirtualBox 均可）
• 启用测试签名模式（Test Signing Mode），否则无法加载未签名驱动：
  cmd bcdedit /set {current} testsigning on

  执行后需重启生效

⚠️ 注意：目标机不要开启快速启动（Fast Startup），否则可能导致调试初始化失败。

方式一：串口调试（Serial）——经典稳定，适合物理机

虽然现在串口看起来有点“复古”，但它是最可靠、兼容性最好的调试方式之一，尤其适用于没有网卡驱动的早期启动阶段调试。

工作原理简述

Windows 内核会通过kdcom.dll把调试数据打包，经由指定 COM 端口发送出去。主机端的 WinDbg 监听对应的串口，接收这些原始字节流并还原成可读的调试事件。

听起来复杂？其实配置起来也就几个命令。

步骤 1：配置目标机

以管理员身份打开 CMD，输入以下命令：

bcdedit /debug on bcdedit /dbgsettings serial debugport:1 baudrate:115200

• /debug on：启用内核调试
• debugport:1：使用 COM1
• baudrate:115200：波特率设为 115200（推荐值）

然后重启目标机。

📌 小贴士：可以用bcdedit /enum all查看当前设置是否生效，找到{current}条目，确认debug字段为Yes。

步骤 2：连接主机与目标机

物理机之间

使用Null Modem 串口线（注意不是普通延长线！），连接两台机器的串口。

虚拟机场景（重点！）

如果你用的是 VMware 或 VirtualBox，需要配置虚拟串口重定向到命名管道。

以 VMware 为例：
1. 编辑虚拟机设置 → 添加串口
2. 选择“输出到命名管道”
3. 输入路径：\\.\pipe\com_1
4. 端口状态勾选“连接时激活”

对 VirtualBox：
- 同样添加串行端口
- 端口号：COM1
- 端口模式：Host Pipe
- 路径：\\.\pipe\com_1

步骤 3：主机端启动调试

打开 WinDbg Preview →File > Start debugging > Kernel mode

选择Serial标签页，填写：

• Port:\\.\COM3（根据你主机实际分配的串口号调整）
• Baud Rate:115200
• ✅ Reuse existing connection

点击 OK，你应该会在输出窗口看到类似：

Connected to Windows 10 x64 Target Symbol file loaded: ... kd>

恭喜，连接成功！你现在已经在kd>提示符下，可以开始执行调试命令了。

🔧 常见坑点提醒：
- 波特率两端必须一致；
- 使用真正的 Null Modem 线，否则通信失败；
- 如果主机没有物理串口，确保虚拟串口映射正确。

方式二：网络调试（Net）——速度快，推荐用于虚拟机

如果说串口是“老派但稳”，那网络调试就是“现代且快”。尤其是对于虚拟机用户，无需额外硬件，千兆网络下调试速度远超串口。

而且微软还提供了专用工具kdnet.exe，能自动完成大部分配置，简直是懒人福音。

工作原理一句话

调试数据通过 TCP 协议传输，默认走 50000 端口，使用 KDNET 驱动封装，效率高、延迟低。

步骤 1：准备 kdnet 工具

从 WDK 安装目录复制以下两个文件到目标机：
-kdnet.exe
-VerifiedNICList.xml

通常位于：

C:\Program Files (x86)\Windows Kits\10\Debuggers\x64\

步骤 2：查找可用网卡

在目标机上运行：

kdnet.exe

你会看到类似输出：

NicIndex: 12 FriendlyName: "Intel(R) Ethernet Connection" NicAddress: 192.168.1.100

记下网卡 IP 地址（这里是192.168.1.100）

步骤 3：生成密钥并配置调试参数

假设你的主机 IP 是192.168.1.50，执行：

kdnet.exe 192.168.1.100 50000

输出示例：

Enabling a net transport for kernel debugging. Key=1.2.3.4.5.6.7.8

这个1.2.3.4.5.6.7.8就是共享密钥，务必保存好！

同时，kdnet 会自动修改 BCD 设置，并开放防火墙端口。

步骤 4：主机端连接

打开 WinDbg Preview →File > Start debugging > Kernel mode > Network

填写：
- Key:1.2.3.4.5.6.7.8.50000:192.168.1.50
- 格式是<key>.<port>:<host-ip>
- GUID: 自动生成即可（也可手动填）

点击Attach

几秒钟后，如果一切顺利，就会进入kd>命令行界面。

✅ 成功标志：能看到目标机的内核版本、CPU 架构等信息。

💡 小技巧：可以把这套流程写成批处理脚本，以后一键部署。

调试连上了，接下来做什么？

连接只是第一步。真正有用的是你能用 WinDbg 干什么。

以下是几个高频命令，建议收藏：

举个例子：如果目标机蓝屏了，你第一时间输入：

!analyze -v

WinDbg 会自动告诉你崩溃发生在哪个模块、错误代码是什么、可能的原因有哪些。很多时候，一眼就能看出是不是你自己写的驱动出了问题。

常见问题怎么排？

别慌，几乎所有新手都会遇到这些问题。我们列几个典型的，配上解决办法。

❌ 问题1：一直显示 “Waiting to reconnect…”

可能原因：
- 目标机没开调试模式
- 物理连接没插好
- 虚拟机串口没映射到位
- 网络不通或端口被占

排查方法：
- 在目标机运行bcdedit /enum all，确认{current}的debug是yes
- 检查 IP 是否在同一子网
- 查看任务管理器，确认kdnet.exe是否在运行
- 关闭杀毒软件试试

❌ 问题2：符号加载失败，“No symbols found”

这是最常见的困扰。

解决方案三步走：

1. 设置符号路径：
   dbg .sympath SRV*C:\Symbols*https://msdl.microsoft.com/download/symbols

2. 清除缓存重来：
   dbg .symfix .reload /f

3. 测试网络连通性：
   在浏览器访问 https://msdl.microsoft.com/download/symbols，看能否打开

💡 建议提前预下载常用 PDB 文件，避免每次都要联网拉取。

❌ 问题3：连接一下就断开

常见诱因：
- 快速启动导致内核初始化不完整
- 多网卡环境下 kdnet 选错了 NIC
- 防火墙拦截了 50000 端口

应对策略：
- 禁用快速启动（控制面板 → 电源选项）
- 显式指定网卡索引运行：
cmd kdnet.exe 192.168.1.100 50000 /nic 12
- 检查 Windows Defender 防火墙入站规则

USB 调试？特殊设备才用得上

还有一种方式叫USB 2.0 调试，主要用于 Surface、IoT 设备或某些嵌入式平台。

它需要特殊的 USB 调试探针（如 Intel FTK），并且主板要支持调试模式。普通 PC 很难用起来，这里简单提一句：

bcdedit /dbgsettings usb targetname:MyDevice

然后在 WinDbg 中选择 USB 连接类型。除非你在做移动设备开发，否则基本不用考虑这种方式。

实战建议：这样用更高效

经过多次实战总结，这几个做法值得坚持：

1. 优先用网络调试
   特别是在虚拟机环境中，速度快、配置灵活，比串口方便太多。

2. 统一使用 WinDbg Preview
   别再回头用老版 WinDbg 了。新版不仅界面友好，扩展性强，关键是持续更新，bug 更少。

3. 建立标准化调试脚本
   比如写个setup_debug.bat：
   bat @echo off echo 正在启用内核调试... bcdedit /debug on bcdedit /dbgsettings net hostip:192.168.1.50 port:50000 key:1.2.3.4.5.6.7.8 echo 配置完成，请重启目标机。 pause

4. 开启日志记录
   每次调试都留档：
   dbg .logopen c:\debuglogs\session_%date%.txt

5. 善用时间旅行调试（TTD）
   对于偶发性 bug，TTD 可以录制执行轨迹，支持反向执行，简直是神器。虽然 setup 稍复杂，但值得投入学习。

6. 独立调试网络段
   如果条件允许，给调试用的主机和目标机单独组一个小局域网，避免业务流量干扰调试稳定性。

最后说点心里话

掌握 WinDbg Preview 的双机调试能力，不只是学会了一个工具，更是建立起一种系统级思维方式。

你会开始习惯问自己：“这背后到底发生了什么？”
而不是停留在“好像重启就好了”。

面对蓝屏不再慌张，看到 IRQL 错误也能冷静分析。这种掌控感，只有真正动手调试过的人才懂。

所以别怕麻烦，哪怕第一次连不上、符号加载失败、命令敲错……都没关系。每一个报错信息都是线索，每一次重试都在逼近真相。

现在就开始吧。准备好两台机器，打开 WinDbg Preview，按下那个“Attach”按钮。

下一秒，也许就是你第一次看到 Windows 内核心跳的时刻。

如果你在搭建过程中遇到任何问题，欢迎在评论区留言交流，我们一起解决。