在 Visual Studio Code (VSCode) 中运行 Rust 程序

在 Visual Studio Code (VSCode) 中运行 Rust 程序需配置开发环境并利用 Cargo 命令或调试工具。以下是详细步骤：

一、基础环境准备

1. 安装 Rust 工具链

   • 通过 rustup 安装 Rust 编译器（rustc）和包管理器（cargo）。
   • 验证安装：

     rustc --version  查看编译器版本
     cargo --version  查看包管理器版本
     

2. 安装 VSCode 扩展

   • 核心插件：
     • rust-analyzer（语言支持）
     • CodeLLDB（调试）
     • crates（依赖管理）
   • 可选插件：
     • Even Better TOML（配置文件高亮）
     • Error Lens（错误提示增强）

---

二、创建并运行项目

1. 新建 Rust 项目

   cargo new my_project  创建新项目
   cd my_project          进入项目目录
   code .                 用 VSCode 打开项目
   

2. 编译与运行

   • 终端运行：

     cargo build    编译项目
     cargo run      编译并运行
     

     默认输出 "Hello, world!"。

   • 快捷操作：

     • 在 main.rs 文件中，点击 fn main() 上方的 ▶ Run 或 ▷ Debug 按钮。
     • 使用快捷键 Ctrl+Shift+ 打开终端，直接输入 cargo run。

---

三、配置调试环境

1. 生成调试配置文件

   • 按 Ctrl+Shift+D 打开调试面板，点击 "create a launch.json file"。
   • 选择 "Rust" 或 "GDB/LLDB" 调试器，自动生成 .vscode/launch.json。

2. 修改 launch.json 示例

   {
     "version": "0.2.0",
     "configurations": [
       {
         "name": "Debug executable",
         "type": "lldb",  // 或 "cppdbg"（Windows）
         "request": "launch",
         "program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}", // 可执行文件路径
         "args": [],      // 命令行参数
         "cwd": "${workspaceFolder}",
         "preLaunchTask": "cargo build"  // 调试前自动编译
       }
     ]
   }
   

   • Windows 路径示例：

     "program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}.exe"
     

3. 启动调试

   • 设置断点：点击代码行号左侧空白区域。
   • 按 F5 或点击绿色播放按钮启动调试。
   • 使用调试工具栏（继续 F5、单步跳过 F10、单步调试 F11）。

---

四、常用调试技巧

1. 传递命令行参数

   • 在 launch.json 的 args 字段中添加参数：

     "args": ["arg1", "arg2"]
     

2. 保存时自动格式化

   • 在 VSCode 设置中启用：

     {
       "editor.formatOnSave": true,
       "[rust]": {
         "editor.defaultFormatter": "rust-lang.rust-analyzer"
       }
     }
     

3. 快速检查代码

   cargo check  仅检查编译错误，不生成可执行文件
   

---

五、常见问题解决

• 插件未生效：
  • 重启 VSCode 或执行命令 Rust Analyzer: Restart。
  • 确保项目根目录包含 Cargo.toml。
• 调试失败：
  • 检查 launch.json 中的可执行文件路径是否正确。
  • 确保已安装调试器（如 gdb 或 lldb）。
    通过以上步骤，可高效在 VSCode 中编写、编译、调试 Rust 程序。更多细节可参考官方文档或社区教程。