在 Visual Studio Code (VSCode) 中运行 Rust 程序
<h2>在 Visual Studio Code (VSCode) 中运行 Rust 程序需配置开发环境并利用 Cargo 命令或调试工具。以下是详细步骤：</h2><p><img src="data/attachment/forum/202510/11/225630jmkigku00mu5urrq.webp" alt="05d742824eba481588940c8183b78871.webp" title="05d742824eba481588940c8183b78871.webp" /></p>
<p>一、基础环境准备</p>
<ol>
<li>
<p>安装 Rust 工具链</p>
<ul>
<li>通过 <code>rustup</code> 安装 Rust 编译器（<code>rustc</code>）和包管理器（<code>cargo</code>）。</li>
<li>验证安装：
<pre><code class="language-bash">rustc --version查看编译器版本
cargo --version查看包管理器版本
</code></pre>
</li>
</ul>
</li>
<li>
<p>安装 VSCode 扩展</p>
<ul>
<li>核心插件：
<ul>
<li><code>rust-analyzer</code>（语言支持）</li>
<li><code>CodeLLDB</code>（调试）</li>
<li><code>crates</code>（依赖管理）</li>
</ul>
</li>
<li>可选插件：
<ul>
<li><code>Even Better TOML</code>（配置文件高亮）</li>
<li><code>Error Lens</code>（错误提示增强）</li>
</ul>
</li>
</ul>
</li>
</ol>
<hr />
<p>二、创建并运行项目</p>
<ol>
<li>
<p>新建 Rust 项目</p>
<pre><code class="language-bash">cargo new my_project创建新项目
cd my_project 进入项目目录
code . 用 VSCode 打开项目
</code></pre>
</li>
<li>
<p>编译与运行</p>
<ul>
<li>
<p>终端运行：</p>
<pre><code class="language-bash">cargo build 编译项目
cargo run 编译并运行
</code></pre>
<p>默认输出 "Hello, world!"。</p>
</li>
<li>
<p>快捷操作：</p>
<ul>
<li>在 <code>main.rs</code> 文件中，点击 <code>fn main()</code> 上方的 ▶ Run 或 ▷ Debug 按钮。</li>
<li>使用快捷键 <code>Ctrl+Shift+</code> 打开终端，直接输入 <code>cargo run</code>。</li>
</ul>
</li>
</ul>
</li>
</ol>
<hr />
<p>三、配置调试环境</p>
<ol>
<li>
<p>生成调试配置文件</p>
<ul>
<li>按 <code>Ctrl+Shift+D</code> 打开调试面板，点击 "create a launch.json file"。</li>
<li>选择 "Rust" 或 "GDB/LLDB" 调试器，自动生成 <code>.vscode/launch.json</code>。</li>
</ul>
</li>
<li>
<p>修改 launch.json 示例</p>
<pre><code class="language-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"// 调试前自动编译
}
]
}
</code></pre>
<ul>
<li>Windows 路径示例：
<pre><code class="language-json">"program": "${workspaceFolder}/target/debug/${workspaceFolderBasename}.exe"
</code></pre>
</li>
</ul>
</li>
<li>
<p>启动调试</p>
<ul>
<li>设置断点：点击代码行号左侧空白区域。</li>
<li>按 <code>F5</code> 或点击绿色播放按钮启动调试。</li>
<li>使用调试工具栏（继续 <code>F5</code>、单步跳过 <code>F10</code>、单步调试 <code>F11</code>）。</li>
</ul>
</li>
</ol>
<hr />
<p>四、常用调试技巧</p>
<ol>
<li>
<p>传递命令行参数</p>
<ul>
<li>在 <code>launch.json</code> 的 <code>args</code> 字段中添加参数：
<pre><code class="language-json">"args": ["arg1", "arg2"]
</code></pre>
</li>
</ul>
</li>
<li>
<p>保存时自动格式化</p>
<ul>
<li>在 VSCode 设置中启用：
<pre><code class="language-json">{
"editor.formatOnSave": true,
"": {
"editor.defaultFormatter": "rust-lang.rust-analyzer"
}
}
</code></pre>
</li>
</ul>
</li>
<li>
<p>快速检查代码</p>
<pre><code class="language-bash">cargo check仅检查编译错误，不生成可执行文件
</code></pre>
</li>
</ol>
<hr />
<p>五、常见问题解决</p>
<ul>
<li>插件未生效：
<ul>
<li>重启 VSCode 或执行命令 <code>Rust Analyzer: Restart</code>。</li>
<li>确保项目根目录包含 <code>Cargo.toml</code>。</li>
</ul>
</li>
<li>调试失败：
<ul>
<li>检查 <code>launch.json</code> 中的可执行文件路径是否正确。</li>
<li>确保已安装调试器（如 <code>gdb</code> 或 <code>lldb</code>）。<br />
通过以上步骤，可高效在 VSCode 中编写、编译、调试 Rust 程序。更多细节可参考官方文档或社区教程。</li>
</ul>
</li>
</ul>
页:
[1]