调试配置文件
调试配置文件也是位于项目的.vscode
目录下,名为launch.json
。在项目刚建立的时候这个文件是不存在的,可以在调试界面中,先点击齿轮按钮选择项目所使用的语言,这里要选择“Python”;再使用下拉列表中的“添加配置”功能添加这个文件。对于Python,这个文件在建立的时候会自动生成常用的项目类型用的调试配置,可以直接按照项目对其中的内容进行删减。
configurations
一项中的内容列出了项目中要使用的调试配置,其中每个由一对大括号括起的内容是一个配置单元。这个配置单元里主要由配置名称、配置类型、启动指令文件、项目入口文件或者模块、启动参数等内容组成。这里给出一个示例。
{
"name": "Python: Main",
"type": "python",
"request": "launch",
"module": "main",
"pythonPath": "${config:python.pythonPath}",
"envFile": "${workspaceFolder}/.env",
"console": "integratedTerminal",
"internalConsoleOptions": "openOnSessionStart",
"debugOptions": [
"RedirectOutput"
]
}
示例中使用${config:python.pythonPath}
引用了之前工作区配置中的Python解释器位置,module
指定了项目启动模块,也可以使用program
来指定启动文件。
此外还可以用${workspaceFolder}
来指代当前工作区目录,用${config:}
来引用配置文件中的值。
调试配置文件中常用的内容项主要有以下这些,可以选择用来配置需要的调试选项。
name
,当前调试功能的名称;type
,调试类型,根据项目语言选择,Python项目为python
;request
,调试请求类型,可选attach
和launch
,Python一般使用launch
;preLaunchTask
,在开始执行前要执行的任务,任务在.vscode
目录中的task.json
中定义;postDebugTask
,在调试结束之后要执行的任务;internelConsoleOptions
,集成命令行选项,可以用来控制如何显示集成命令行界面;program
,要执行调试的可执行文件或者代码文件;args
,要传递给调试代码的命令行参数;env
,调试环境变量文件;cwd
,调试工作目录,用来定位相关依赖文件;port
,使用attach
模式时附加到进程的端口;stopOnEntry
,当调试开始是是否立刻中断运行;console
,决定使用哪个命令行界面,可选integratedTerminal
、externelTerminal
和None
。