Share via

MDbg.exe（.NET Framework 命令行调试程序）

  • 项目

更新：2011 年 4 月

.NET Framework 命令行调试器可以帮助工具供应商和应用程序开发人员查找并修复面向 .NET Framework 公共语言运行时的程序中的 Bug。 此工具使用运行时调试 API 提供调试服务。 还可以使用 MDbg.exe 来仅调试托管代码；不支持调试非托管代码。

安装 Visual Studio 和 Windows SDK 时会自动安装此工具。 要运行工具，我们建议您使用 Visual Studio 命令提示符或 Windows SDK 命令提示符（也称 CMD Shell）。 您可以使用这些实用程序轻松运行工具，而不需要导航到安装文件夹。 有关更多信息，请参见 Visual Studio 和 Windows SDK 命令提示。

  • 如果您的计算机上已安装了 Visual Studio：在任务栏上依次单击 Start、All Programs、Visual Studio、Visual Studio Tools、Visual Studio Command Prompt。

    - 或 -

    如果您的计算机上已安装了 Windows SDK：在任务栏上依次单击 Start、All Programs、Windows SDK 文件夹和 Command Prompt（或CMD Shell)。

  • 在命令提示处，键入下列命令：

MDbg [ProgramName[arguments]] [options]

命令

在调试器中 （由**mdbg>**提示指示），键入下一节中所述的命令之一：

command [参数]

MDbg.exe 命令区分大小写。

命令

说明

ap[rocess] [number]

切换到另一个调试的进程或打印可用进程。 数字不是真正的进程 ID (PID)，而是一个0-索引的列表。

a[ttach] [pid]

附加到进程或打印可用进程。

b[reak] [ClassName.Method |FileName:LineNo

在指定方法处设置断点。 按顺序扫描模块。

  • break FileName:LineNo 在源中的某个位置设置断点。

  • break ~number 在与 x 命令一起显示的最新符号上设置断点。

  • break module!ClassName.Method+IlOffset 在完全限定位置上设置断点。

block[ingObjects]

显示用来阻止线程的监视器锁。

ca[tch] [exceptionType]

使调试器在所有异常上中断，而不只是未经处理的异常。

cl[earException]

将当前异常标记为已处理，以便可继续执行。 如果不处理异常的原因，异常可能会很快再次引发。

conf[ig] [option value]

显示所有可配置选项并显示无任何选项值如何调用选项。 如果指定了选项，请将 value 设置为当前选项。 当前，下列选项可用：

  • load 命令使用时将 extpath 设置路径来搜索扩展。

  • extpath+ 为加载扩展而添加路径。

del[ete]

删除断点。

de[tach]

与调试的进程分离。

d[own] [frames]

下移活动堆栈帧。

echo

向控制台回显消息。

enableNotificationtypeName0 | 1

为指定类型启用 (1) 和禁用 (0) 自定义通知。

ex[it] [exitcode]

退出 MDbg.exe shell，并选择指定的进程退出代码。

fo[reach] [OtherCommand]

对所有线程执行命令。 OtherCommand 是对一个线程执行的有效命令；foreach OtherCommand 则对所有线程执行同一命令。

f[unceval] [-ad Num] functionName [args ...]

对当前活动线程进行函数求值，其中，要求值的函数为 functionName。 函数名必须完全限定，包括命名空间。

-ad 选项指定用于解析函数的应用程序域。 如果未指定 -ad 选项，则用于解析的应用程序域默认为用于函数求值的线程所在的应用程序域。

如果要进行求值的函数不是静态的，则传入的第一个参数应为 this 指针。 在所有应用程序域中搜索函数求值所需的参数。

若要请求应用程序域值，请使用模块和应用程序域名添加前缀变量；例如 funceval -ad 0 System.Object.ToString hello.exe#0!MyClass.g_rootRef。 此命令在应用程序域 0 中对函数 System.Object.ToString 进行求值。 由于 ToString 方法为实例函数，因此，第一个参数必须为 this 指针。

g[o]

使程序继续直到其遇到断点，退出程序，或事件（例如，未经处理的异常）使程序停止。

h[elp] [command]

- 或 -

?[命令]

显示所有命令的说明或对指定命令的详细说明。

ig[nore] [event]

让调试器仅在遇到未经处理的异常时停止。

int[ercept] FrameNumber

将调试器回滚到指定的帧号码。

如果调试器遇到异常，使用此命令可以将调试器回滚到指定的帧号码。 可通过使用 设置 命令来更改程序状态并通过使用 转到 命令继续操作。

k[ill]

停止活动进程。

l[ist] [模块| appdomains|程序集]

显示已加载的模块、应用程序域或程序集。

lo[ad] assemblyName

按以下方式加载扩展：加载指定的程序集，然后尝试从 Microsoft.Tools.Mdbg.Extension.Extension 类型运行静态方法 LoadExtension。

日志 [事件类型]

设置或显示记录的事件。

mo[de] [option on/off]

设置不同的调试器选项。 使用不带任何选项的 mode 来获取调试模式的列表及其当前设置。

mon[itorInfo] monitorReference

显示对象监视器锁信息。

newo[bj] typeName [arguments...]

创建 typeName 类型的新对象。

n[ext]

运行代码并移动到下一行（即使下一行包含多个函数调用）。

Opendump pathToDumpFile

打开指定的转储文件以进行调试。

o[ut]

移动到当前函数的末尾。

pa[th] [pathName]

如果二进制文件中的位置不可用，则在指定路径中搜索源文件。

p[rint] [var] | [-d]

打印相应范围内的所有变量 (print)，打印指定变量 (print var)，或者打印调试器变量 (print -d)。

printe[xception] [-r]

输出当前线程上的最后一个异常。 使用 –r（递归）选项遍历异常对象上的 InnerException 属性，以获取有关整个异常链的信息。

pro[cessenum]

显示活动进程。

q[uit] [exitcode]

退出 MDbg.exe shell，可以选择指定进程退出代码。

re[sume] [* | [~]threadNumber]

继续当前线程或 threadNumber 参数指定的线程。

如果指定 threadNumber 参数为 *，或者线程号以 ~ 开始，则该命令将应用于所有线程，threadNumber 指定的线程除外。

无法继续未挂起的线程。

r[un] [-d(ebug) | -o(ptimize) |-enc] [[path_to_exe] [args_to_exe]]

停止当前进程（如果存在）并启动一个新进程。 如果未提供可执行参数，此命令将运行上次使用 run 命令执行的程序。 如果提供了可执行参数，将使用提供的可选参数运行指定的程序。

如果忽略类加载、模块加载和线程启动事件（默认情况下如此），程序将在遇到主线程的第一条可执行指令时停止。

可通过使用一下三个标记之一迫使调试程序对代码进行实时 (JIT) 编译：

  • -d(ebug) 禁用优化。 这是 MDbg.exe 的默认值。

  • -o(ptimize) 强制代码更像在高度器外部一样运行，而且也使调试体验更困难。 这是默认值以供调试器外部使用。

  • -enc 启用“编辑并继续”功能，但会招致性能问题。

set variable=value

更改任意的范围内变量的值。

您还可以创建自己的调试器变量，然后在自己的应用程序中将引用值赋给这些变量。 这些值充当原始值的句柄，即使原始值超出范围。 所有调试器变量都必须以 $ 开头（例如 $var）。 使用 命令将这些句柄设置为空，便可以清除这些句柄。

set $var=

Setip [-il] number

将文件中当前的指令指针设置到指定位置。 如果指定 -il 选项，则数字表示方法中的 Microsoft 中间语言 (MSIL) 偏移量。 否则，number 表示源代码中的行号。

sh[ow] [lines]

指定要显示的行数。

s[tep]

开始执行当前行的下一个函数；如果没有要单步执行的函数，则移动到下一行。

su[spend] [* | [~]threadNumber]

挂起当前线程或 threadNumber 参数指定的线程。 如果 threadNumber 指定为 *，则该命令将应用于所有线程。 如果线程号以 ~ 开头，则该命令应用于所有线程，threadNumber 指定的线程除外。 使用 go 或 step 命令运行进程时，不会运行挂起的线程。 如果进程中没有未挂起的线程，即使您发出 go 命令，该进程也不会继续。 在这种情况下，按 CTRL-C 可中断进程。

sy[mbol] commandName [commandValue]

指定下列命令之一：

  • symbol path ["value"] - 显示或设置当前符号路径。

  • symbol addpath "value" - 添加到当前符号路径。

  • symbol reload ["module"]- 重新加载所有符号或指定模块的符号。

  • symbol list [module] - 显示当前为所有模块或指定模块加载的符号。

t 线路 ] 新线路 [- 昵称名 ]

不带参数的线程命令显示当前进程中的所有托管线程。 线程通常由其线程号标识；不过，如果线程有分配的别名，则显示该别名。 可使用 -nick 参数将别号分配给线程。

  • thread -nick threadName 为当前运行的线程分配一个昵称。

昵称不能为数字。 如果已经为当前线程分配了昵称，则使用新的昵称来替换旧的昵称。 如果新昵称为空字符串 ("")，则删除当前线程的昵称并且不给线程分配新昵称。

u[p]

上移活动堆栈帧。

uwgc[handle] [var] | [address]

打印句柄所跟踪的变量。 可以按名称或地址来指定句柄。

时间

显示当前处于活动状态的 when 语句。

删除所有|num [num [num …]] - 删除按编号指定的 when 语句，或所有 when 语句，前提是指定了 all。

当 stopReason [specific_condition] 执行 cmd [cmd [cmd …] ] 时，stopReason 参数可以为以下参数之一：

StepComplete, ProcessExited, ThreadCreated, BreakpointHit, ModuleLoaded, ClassLoaded, AssemblyLoaded, AssemblyUnloaded, ControlCTrapped, ExceptionThrown, UnhandledExceptionThrown, AsyncStop, AttachComplete, UserBreak, EvalComplete, EvalException, RemapOpportunityReached, NativeStop.

具体情形 可为下列之一：

  • number - 对于 ThreadCreated 和 BreakpointHit，只有当具有相同值的线程 ID/断点号引起停止时才会触发操作。

  • [!]name - 对于 ModuleLoaded、ClassLoaded、AssemblyLoaded、AssemblyUnloaded、 ExceptionThrown和 UnhandledExceptionThrown, 仅该名称与 stopReason匹配时，会触发操作。

对于其他 stopReason 的值，specific_condition 必须为空。

w[here] [-v] [-c depth] [threadID]

显示有关堆栈帧的调试信息。

  • -v 选项为显示的每个堆栈帧提供详细信息。

  • 为 depth 指定一个数字可以限制显示的帧数。 使用 all 命令可以显示所有帧。 默认值为 100。

  • 如果指定 threadID 参数，则可以控制哪个线程与堆栈关联。 默认只与当前线程关联。 使用 all 命令可以获取所有线程。

x [-c numSymbols] [module[!pattern]]

显示为模块匹配 pattern 的函数。

如果指定了 numSymbols，则输出将局限于指定的数目。 如果 !（指示正则表达式）未指定 模式，显示所有的功能。 如果未提供 module，则显示加载的所有模块。 符号 (~#) 可用于通过 break 命令来设置断点。

备注

使用特定编译器标志编译要调试的应用程序使您的编译器生成调试符号。 有关这些标志的更多信息，请参见编译器的文档。 可以调试优化应用程序，但某些调试信息将会缺失。 例如，许多局部变量将无法看到，并且源代码行也会变得不准确。

在编译应用程序之后，在命令提示符下键入 mdbg 以启动调试会话，如以下示例所示。

C:\Program Files\Microsoft Visual Studio 8\VC>mdbg
MDbg (Managed debugger) v2.0.50727.42 (RTM.050727-4200) started.
Copyright (C) Microsoft Corporation. All rights reserved.

For information about commands type "help";
to exit program type "quit".
mdbg>

mdbg> 提示符表示您处于调试器中。

处于调试器中之后，请使用上一部分所述的命令和参数。

请参见

参考

Visual Studio 和 Windows SDK 命令提示

其他资源

.NET Framework 工具

修订记录

Date

修订记录

原因

2011 年 4 月

添加了有关使用 Visual Studio 和 Windows SDK 命令提示符的信息。

信息补充。