// 
//     Licensed to the Apache Software Foundation (ASF) under one
//     or more contributor license agreements.  See the NOTICE file
//     distributed with this work for additional information
//     regarding copyright ownership.  The ASF licenses this file
//     to you under the Apache License, Version 2.0 (the
//     "License"); you may not use this file except in compliance
//     with the License.  You may obtain a copy of the License at
// 
//       http://www.apache.org/licenses/LICENSE-2.0
// 
//     Unless required by applicable law or agreed to in writing,
//     software distributed under the License is distributed on an
//     "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY
//     KIND, either express or implied.  See the License for the
//     specific language governing permissions and limitations
//     under the License.
//

= 调试 C/C++ 项目教程
:jbake-type: tutorial
:jbake-tags: tutorials 
:jbake-status: published
:icons: font
:syntax: true
:source-highlighter: pygments
:toc: left
:toc-title:
:description: 调试 C/C++ 项目教程 - Apache NetBeans
:keywords: Apache NetBeans, Tutorials, 调试 C/C++ 项目教程


2013 年 3 月 [修订版本号：V8.0-1]

下面的简明教程将为您介绍 NetBeans IDE 中用于调试 C 或 C++ 项目的一些功能。


== 要求

*要学习本教程，您需要具备以下软件和资源。*

|===
|软件或资源 |要求的版本 

|NetBeans IDE |link:https://netbeans.org/downloads/index.html[+带有 NetBeans C/C++ 插件模块的版本 7.4 或 8.0+] 

|Java 开发者工具包 (JDK) |link:http://www.oracle.com/technetwork/java/javase/downloads/index.html[+版本 7 或 8+] 
|===

有关下载并安装必需软件的信息，请参见 link:../../../community/releases/80/install.html[+NetBeans IDE 安装说明+]和link:../../../community/releases/80/cpp-setup-instructions.html[+配置 NetBeans IDE 以使用 C/C++/Fortran+]。


== 创建样例项目

带有 C/C++ 的 NetBeans IDE 使用了  ``gdb``  调试器，并提供了很多项目调试功能。要了解这些功能，请使用  ``Quote`` （报价）项目。如果还没有创建这个项目，可执行以下操作：

1. 选择 "File"（文件）> "New Project"（新建项目）。
2. 在项目向导中，依次展开 "Samples"（样例）类别和 "C/C++" 子类别。
3. 选择 "Applications"（应用程序）子类别，然后选择 ``报价`` 项目。单击 "Next"（下一步），然后单击 "Finish"（完成）。


== 创建断点

您可以随时在代码中创建并操作断点，而不用启动调试会话。


=== 创建和删除行断点

1. 在  ``Quote_1``  项目中，打开  ``quote.cc``  文件。
2. 在源代码编辑器窗口靠近 171 行 ( ``response = readChar("Enter disk module type: (S for single disks, R for RAID; Q - exit)", 'S');`` ) 的左旁注中单击，设置一个行断点。该行将以红色突出显示，表明断点已设置。
image::images/line_breakpoint1.png[]

[start=3]
. 您可以通过单击位于左旁注中的图标来删除断点。

[start=4]
. 选择 "Window"（窗口）> "Debugging"（调试）> "Breakpoints"（断点）打开 "Breakpoints"（断点）窗口。在 C/C++ 节点下列出您的行断点。
image::images/line_breakpoint2.png[]

[start=5]
. 展开 C/C++ 节点可查看您的断点。
image::images/line_breakpoint2_expand.png[]


=== 创建函数断点

1. 在 "Breakpoints"（断点）窗口左旁注中单击 "Create New Breakpoint"（创建新断点）按钮，或者选择 "Debug"（调试）> "New Breakpoint"（新建断点）（Ctrl+Shift+F8 组合键）以打开 "New Breakpoint"（新建断点）对话框。
2. 在 "Debugger Type"（调试器类型）列表中，选择 "Native"（本机）。
3. 在 "Breakpoint Type"（断点类型）列表中，选择 "Function"（函数）。
4. 在 "Function Name"（函数名）文本字段中键入函数名  ``Customer::GetDiscount`` 。单击 "OK"（确定）。 
image::images/function_breakpoint1.png[]

[start=5]
. 函数断点已设置，并且已添加到 "Breakpoints"（断点）窗口列表中。
image::images/function_breakpoint2.png[]

[start=6]
. 单击左旁注中的 "Select Breakpoint Groups"（选择断点组）按钮以将断点组织到不同的组，然后选择 "Type"（类型）。
image::images/group_breakpoint_type.png[]

[start=7]
. 展开 "File:Line"（文件:行）和 "Function"（函数）组以显示您的断点。
image::images/breakpoint_types.png[]


== 启动调试会话

在启动调试会话时，IDE 会启动  ``gdb``  调试器，然后在调试器中运行应用程序。IDE 将自动打开调试器窗口和调试器工具栏，并在 "Output"（输出）窗口中打印调试器输出。

1. 通过单击 "Debug Project"（调试项目）按钮 image::images/debugbutton.png[] 或通过选择 "Debug"（调试）> "Debug Project"（调试项目），为  ``Quote_1``  项目启动调试会话。
此时将启动调节器，并运行应用程序。显示调试工具栏。
image::images/debugger_toolbar.png[]

[start=2]
. 选择 "Window"（窗口）> "Debugging"（调试）> "Sessions"（会话）打开 "Sessions"（会话）窗口。
调试会话将显示在此窗口中。


== 检查应用程序状态

1.  ``Quote_1``  应用程序会提示您在 "Output (Debug)"（输出（调试））窗口中输入信息。
2. 在提示 "Enter customer name:"（输入客户名：）后输入客户名。

该应用程序将在您先前设置的 Customer::GetDiscount 函数断点处停止，并且 customer.cc 文件将在编辑器中调用该函数的行中打开。此时 "Breakpoints"（断点）窗口会列出先前设置的两个断点。函数断点的断点图标顶端会出现绿色程序计数器箭头。
image::images/function_breakpoint3.png[]


[start=3]
. 单击 "Call Stack"（调用堆栈）窗口的标签，或者选择 "Window"（窗口）> "Debugging"（调试）> "Call Stack"（调用堆栈）。此时调用堆栈将显示三个框架。
image::images/call_stack.png[]

[start=4]
. 打开 "Variables"（变量）窗口，此时您看到显示了一个变量。

[start=5]
. 单击展开图标以展开此结构。
image::images/local_variables1.png[]

[start=6]
. 单击工具栏中的 "Continue"（继续）按钮。
此时将执行  ``GetDiscount``  函数，同时在 "Output (Debug)"（输出（调试））窗口中显示客户折扣。此时系统会提示输入信息。

[start=7]
. 按照提示输入信息。

程序会在下一个断点（即先前设置的行断点）处停止。在  ``quote.cc``  文件中，断点图标顶端会出现绿色程序计数器箭头，指示程序暂停在哪一行。 

image::images/line_breakpoint3.png[]


[start=8]
. 单击 "Variables"（变量）标签，注意会显示局部变量的详细列表。 
image::images/local_variables2.png[]

[start=9]
. 单击 "Call Stack"（调用堆栈）标签，注意此时堆栈中有一个框架。

[start=10]
. 选择 "Window"（窗口）> "Debugging"（调试）> "Registers"（注册）。
此时将打开 "Registers"（注册）窗口，其中显示注册的当前内容。 
image::images/registers.png[] 

[start=11]
. 选择 "Window"（窗口）> "Debugging"（调试）> "Disassembly"（反汇编）。
此时将打开 "Disassembly"（反汇编）窗口，其中显示当前源文件的汇编指令。 
image::images/disassembly.png[] 

[start=12]
. 单击工具栏中的 "Continue"（继续）按钮，并继续按照提示在 "Output"（输出）窗口中输入信息，直到程序完成。

[start=13]
. 按 Enter 键退出程序后，调试会话便会结束。要在程序执行完毕以前结束调试会话，可以在工具栏中单击 "Finish Debugger Session"（完成调试器会话）按钮，或者选择 "Debug"（调试）> "Finish Debugger Session"（完成调试器会话）。


== 另请参见

有关在 NetBeans IDE 中使用 C/C++/Fortran 进行开发的更多文章，请参见 link:https://netbeans.org/kb/trails/cnd.html[+C/C++ 学习资源+]。

link:mailto:users@cnd.netbeans.org?subject=Feedback:%20Debugging%20C/C++%20Projects%20-%20NetBeans%20IDE%207.4%20Tutorial[+发送有关此教程的反馈意见+]