在 VS Code 中调试
本指南将指导您设置 VS 代码,以调试 Tauri 应用的核心流程。
所有具有 vscode-lldb 扩展的平台
先决条件
安装 vscode-lldb
扩展。
配置 launch.json
创建一个 .vscode/launch.json
文件,并将下面的 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 功能。beforeDevCommand
和 beforeBuildCommand
脚本必须事先执行,或在 preLaunchTask
字段中配置为任务。下面是一个 .vscode/tasks.json
文件示例,其中有两个任务,一个是生成开发服务器的 beforeDevCommand
任务,另一个是 beforeBuildCommand
任务:
{ // 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
{ // 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.json
与 lldb
相同,只是如果您希望在启动之前始终进行编译,则需要添加一个配置组,并将其 launch.json
中的 preLaunchTask
指向它。
这是一个运行开发服务器(相当于 beforeDevCommand
)和编译(cargo build
)作为一组的示例,要使用它,请将 launch.json
中的 preLaunchTask
配置更改为 dev
(或任何你命名的组)。
{ // 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" } } ]}
© 2025 Tauri Contributors. CC-BY / MIT