vscode插件之C/C++
1、给C/C++调试器配置launch.json
-
launch.json用于在VS Code中配置调试器；带着关于生成器几乎所有需要的信息。 -
需要将用于计划调试的可执行文件的路径填充在program字段；必须在launch和attach配置信息中填充。
-
生成的文件包含两个部分，一个为launch配置调试，一个为attach配置调试。
2、配置VS Code的调试行为
- 调试期间可以通过设置和改变下列选项来控制VS Code的行为：
-
program：指定执行debugger的完整路径。
-
symbolSearchPath：告诉windows调试器搜索
.pdb文件的路径。如果有多个路径，则用分号分开，例如：C:\\Symbols;C:\\SymbolDir2。 -
additionalSOLibSearchPath：告知GDB或者LLD去搜索
.so文件的路径。如果有多个路径，用;隔开。-
GDB：UNIX及UNIX-like下的调试工具。
-
LLDB：LLDB是个开源的内置于XCode的具有REPL(read-eval-print-loop)特征的Debugger，其可以安装C++或者Python插件。LLDB是个开源的内置于XCode的具有REPL(read-eval-print-loop)特征的Debugger，其可以安装C++或者Python插件。
-
-
externalConsole
-
windows：如果设置为
True，它将生成外部控制台；如果设置为false，则将会使用VS Code的集成终端； -
Linux：如果设置为
True，它将通知VS Code去生成一个外部控制台；如果设置为false，则将会使用VS Code的集成终端；
-
-
avoidWindowsConsoleRedirection：为了在Windows上支持VSCode与gdb的集成终端，扩展将控制台重定向命令添加到debuggee的参数中，以便在集成终端中显示控制台输入和输出。将此选项设置为
true将禁用它。 -
logging：可选标志，以确定应该将哪些类型的消息记录到调试控制台。
-
exceptions：默认为
true，确定是否应该将异常消息记录到调试控制台。 -
moduleLoad：默认为
true，确定是否应该将模块加载事件记录到调试控制台。 -
programOutput：默认为
true，确定是否应该将程序输出记录到调试控制台。 -
engineLogging：默认为
false，确定是否应该将诊断引擎日志记录到调试控制台。 -
trace：默认为
false，确定是否应该将诊断适配器命令跟踪记录到调试控制台。 -
traceResponse：默认为
false，确定是否应该将诊断适配器命令和响应跟踪记录到调试控制台。
-
-
visualizerFile：调试时
.natvls文件将被使用。 -
showDisplayString：当指定visualizerFile时，showDisplayString将启用显示字符串，打开此选项会导致调试期间性能下降。
举例：
{
"name": "C++ Launch (Windows)",
"type": "cppvsdbg",
"request": "launch",
"program": "C:\\app1\\Debug\\app1.exe",
"symbolSearchPath": "C:\\Symbols;C:\\SymbolDir2",
"externalConsole": true,
"logging": {
"moduleLoad": false,
"trace": true
},
"visualizerFile": "${workspaceRoot}/my.natvis",
"showDisplayString": true
}
3、配置目标应用
下列选项可让你在目标应用程式启动时修改其状态：
-
args：启动程序时传递给程序的命令行参数的JSON数组。例如 ["arg1", "arg2"]，如果要转义字符，则需要对其进行两次转义。例如["{\"arg\": true}]将向您的应用程序发送{"arg1": true}。
-
cwd：设置调试器启动的应用程序的工作目录。
-
enviroment：要添加到程序环境中的环境变量。
举例：
{
"name": "C++ Launch",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceRoot}/a.out",
"args": ["arg1", "arg2"],
"environment": [{"name": "squid", "value": "clam"}],
"cwd": "${workspaceRoot}"
}
4、自定义GDB或者LLDB
下列选项可让你改变GDB或者LLDB的行为：
-
MIMode：指示VS代码将连接到的调试器。必须设置为gdb或lldb。这是根据每个操作系统预先配置的，可以根据需要进行更改。
-
miDebuggerPath：调试器(如gdb)的路径。当只指定可执行文件时，它将为调试器搜索操作系统的路径变量(Linux和Windows上的GDB, OS X上的LLDB)。
-
miDebuggerArgs：传递给调试器的其他参数(如gdb)。
-
stopAtEntry：如果设置为true，调试器应该在目标的入口点停止(在附加时忽略)。默认值为false。
-
setupCommands：要执行的命令的JSON数组，以便设置GDB或LLDB。例如:"setupCommands": [{"text": "target-run"， "description": "run target"， " ignorefailure ": false}]
-
customLaunchSetupCommands：如果提供了，这将用一些其他命令替换用于启动目标的默认命令。例如，这可以是“-target-attach”以便附加到目标进程。空命令列表将用空命令替换启动命令，如果将启动选项作为命令行选项提供给调试器，这将非常有用。例如:“customLaunchSetupCommands”:[{“text”:“target-run”，“description”:“run target”，“ignorefailure”:false}]。
-
launchCompleteCommand：调试器完全设置好后要执行的命令，以便使目标进程运行。允许的值是“执行器运行”、“执行器继续”、“None”。默认值是“execl -run”。
举例：
{
"name": "C++ Launch",
"type": "cppdbg",
"request": "launch",
"program": "${workspaceRoot}/a.out",
"stopAtEntry": false,
"customLaunchSetupCommands": [
{ "text": "target-run", "description": "run target", "ignoreFailures": false }
],
"launchCompleteCommand": "exec-run",
"linux": {
"MIMode": "gdb",
"miDebuggerPath": "/usr/bin/gdb"
},
"osx": {
"MIMode": "lldb"
},
"windows": {
"MIMode": "gdb",
"miDebuggerPath": "C:\\MinGw\\bin\\gdb.exe"
}
}
5、调试dump（转储）文件
C/ c++扩展允许调试Windows上的dump文件以及Linux和OS X上的core dump文件
-
dumpPath：如果要调试Windows转储文件，请将此设置为转储文件的路径，以便在启动配置中启动调试。
-
coreDumPath：要调试指定程序的核心转储文件的完整路径。将其设置为核心转储文件的路径，以便在启动配置中启动调试。注意:MinGw不支持核心转储调试。
6、远程调试或者本地服务器上调试
-
miDebuggerServerAddress：调试器服务器(例如gdbserver)的网络地址，以便连接到远程调试(例如:localhost:1234)。
-
debugServerPath：调试服务器启动的完整路径。
-
debugServerArgs：调试服务器的参数。
-
serverStarted：要在调试服务器输出中查找的服务器启动模式。
-
serverLaunchTimeout：调试器等待debugServer启动的时间(以毫秒为单位)。默认是10000。
7、其他属性
-
processId：默认为
${command.pickProcess}。将显示调试器可以附加到的可用进程列表。建议保留此默认值，但是可以显式地将该属性设置为调试器要附加到的特定进程ID。 -
request：指示配置节是打算启动程序还是附加到已运行的实例。
-
targetArchitecture：由于自动检测到目标体系结构，因此不再需要此选项。
-
type：指示正在使用的底层调试器。使用Visual Studio Windows调试器时必须是cppvsdbg，使用GDB或LLDB时必须是cppdbg。这将在启动时自动设置为正确的值。创建json文件。
-
sourceFileMap：这允许将源的编译时路径映射到本地源位置。它是键/值对的对象，将解析第一个字符串匹配的路径。(例如:"sourceFileMap": {"/mnt/c": "c:\"}将映射调试器返回的以/mnt/c开头的任何路径，并将其转换为c:\。对象中可以有多个映射，但它们将按提供的顺序处理。)
参考：
1.官网：https://github.com/Microsoft/vscode-cpptools/blob/master/launch.md
2.csdn博客：https://blog.csdn.net/wzxlovesy/article/details/76708151
