调试配置文件

调试配置文件也是位于项目的.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:}来引用配置文件中的值。

调试配置文件中常用的内容项主要有以下这些,可以选择用来配置需要的调试选项。

  1. name,当前调试功能的名称;
  2. type,调试类型,根据项目语言选择,Python项目为python
  3. request,调试请求类型,可选attachlaunch,Python一般使用launch
  4. preLaunchTask,在开始执行前要执行的任务,任务在.vscode目录中的task.json中定义;
  5. postDebugTask,在调试结束之后要执行的任务;
  6. internelConsoleOptions,集成命令行选项,可以用来控制如何显示集成命令行界面;
  7. program,要执行调试的可执行文件或者代码文件;
  8. args,要传递给调试代码的命令行参数;
  9. env,调试环境变量文件;
  10. cwd,调试工作目录,用来定位相关依赖文件;
  11. port,使用attach模式时附加到进程的端口;
  12. stopOnEntry,当调试开始是是否立刻中断运行;
  13. console,决定使用哪个命令行界面,可选integratedTerminalexternelTerminalNone