Skip to content
Tauri

在 VS Code 中调试

本指南将指导您设置 VS 代码,以调试 Tauri 应用的核心流程

所有具有 vscode-lldb 扩展的平台

先决条件

安装 vscode-lldb 扩展。

配置 launch.json

创建一个 .vscode/launch.json 文件,并将下面的 JSON 内容粘贴到其中:

.vscode/launch.json
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"type": "lldb",
"request": "launch",
"name": "Tauri Development Debug",
"cargo": {
"args": [
"build",
"--manifest-path=./src-tauri/Cargo.toml",
"--no-default-features"
]
},
// task for the `beforeDevCommand` if used, must be configured in `.vscode/tasks.json`
"preLaunchTask": "ui:dev"
},
{
"type": "lldb",
"request": "launch",
"name": "Tauri Production Debug",
"cargo": {
"args": ["build", "--release", "--manifest-path=./src-tauri/Cargo.toml"]
},
// task for the `beforeBuildCommand` if used, must be configured in `.vscode/tasks.json`
"preLaunchTask": "ui:build"
}
]
}

它直接使用 cargo 来构建 Rust 应用程序,并在开发和生产模式下加载它。

请注意,它不使用 Tauri CLI,因此不会执行独有的 CLI 功能。beforeDevCommandbeforeBuildCommand 脚本必须事先执行,或在 preLaunchTask 字段中配置为任务。下面是一个 .vscode/tasks.json 文件示例,其中有两个任务,一个是生成开发服务器的 beforeDevCommand 任务,另一个是 beforeBuildCommand 任务:

.vscode/tasks.json
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "ui:dev",
"type": "shell",
// `dev` keeps running in the background
// ideally you should also configure a `problemMatcher`
// see https://code.visualstudio.com/docs/editor/tasks#_can-a-background-task-be-used-as-a-prelaunchtask-in-launchjson
"isBackground": true,
// change this to your `beforeDevCommand`:
"command": "yarn",
"args": ["dev"]
},
{
"label": "ui:build",
"type": "shell",
// change this to your `beforeBuildCommand`:
"command": "yarn",
"args": ["build"]
}
]
}

现在,你可以在 src-tauri/src/main.rs 或任何其他 Rust 文件中设置断点,并按下 F5 开始调试。

在 Windows 上使用 Visual Studio Windows 调试器

Visual Studio Windows Debugger 是一个仅适用于 Windows 的调试器,通常比 vscode-lldb 更快,并且对一些 Rust 特性(如枚举)提供更好的支持。

先决条件

安装 C/C++ 扩展,并按照 https://code.visualstudio.com/docs/cpp/config-msvc#_prerequisites 中的步骤安装 Visual Studio Windows 调试器。

配置 launch.json 和 tasks.json

.vscode/launch.json
{
// Use IntelliSense to learn about possible attributes.
// Hover to view descriptions of existing attributes.
// For more information, visit: https://go.microsoft.com/fwlink/?linkid=830387
"version": "0.2.0",
"configurations": [
{
"name": "Launch App Debug",
"type": "cppvsdbg",
"request": "launch",
// change the exe name to your actual exe name
// (to debug release builds, change `target/debug` to `release/debug`)
"program": "${workspaceRoot}/src-tauri/target/debug/your-app-name-here.exe",
"cwd": "${workspaceRoot}",
"preLaunchTask": "ui:dev"
}
]
}

请注意,它不使用 Tauri CLI,因此独占的 CLI 功能不会被执行。tasks.jsonlldb 相同,只是如果您希望在启动之前始终进行编译,则需要添加一个配置组,并将其 launch.json 中的 preLaunchTask 指向它。

这是一个运行开发服务器(相当于 beforeDevCommand)和编译(cargo build)作为一组的示例,要使用它,请将 launch.json 中的 preLaunchTask 配置更改为 dev(或任何你命名的组)。

.vscode/tasks.json
{
// See https://go.microsoft.com/fwlink/?LinkId=733558
// for the documentation about the tasks.json format
"version": "2.0.0",
"tasks": [
{
"label": "build:debug",
"type": "cargo",
"command": "build"
},
{
"label": "ui:dev",
"type": "shell",
// `dev` keeps running in the background
// ideally you should also configure a `problemMatcher`
// see https://code.visualstudio.com/docs/editor/tasks#_can-a-background-task-be-used-as-a-prelaunchtask-in-launchjson
"isBackground": true,
// change this to your `beforeDevCommand`:
"command": "yarn",
"args": ["dev"]
},
{
"label": "dev",
"dependsOn": ["build:debug", "ui:dev"],
"group": {
"kind": "build"
}
}
]
}

© 2024 Tauri Contributors. CC-BY / MIT