Default host: x86_64-pc-windows-msvc
rustup home:  C:\Users\taichi\scoop\persist\rustup-msvc\.rustup

stable-x86_64-pc-windows-msvc (default)
rustc 1.57.0 (f1edd0429 2021-11-29)

rustup home と (default) が末尾に付いているtoolchain名を後で使います。

次にライブラリのバージョンとコミットハッシュを調べるために、rustc --version --verbose を実行します。筆者の環境では以下のように出力されました。

rustc 1.57.0 (f1edd0429 2021-11-29)
binary: rustc
commit-hash: f1edd0429582dd29cccacaf50fd134b05593bd9c
commit-date: 2021-11-29
host: x86_64-pc-windows-msvc
release: 1.57.0
LLVM version: 13.0.0

ここで使うのは、 commit-hash ですね。この例では f1edd0429582dd29cccacaf50fd134b05593bd9c となっていますね。

そしてワークスペースの設定をするために .vscode/settings.json を作成します。

{
  "lldb.launch.sourceMap": {
    "/rustc/f1edd0429582dd29cccacaf50fd134b05593bd9c": "C:\\Users\\taichi\\scoop\\persist\\rustup-msvc\\.rustup\\toolchains\\stable-x86_64-pc-windows-msvc\\lib\\rustlib\\src\\rust"
  }
}

lldb.launch.sourceMap がソースコードをアタッチするための設定項目です。この設定項目ではキー部分に、アタッチしたいソースコードの名前空間を設定します。そして、値部分にソースコードの絶対パスを設定します。

今回のケースでは標準ライブラリにソースコードをアタッチしようとしています。 /rustc/ がプレフィックスで、その後ろにコミットハッシュである f1edd0429582dd29cccacaf50fd134b05593bd9c を連結していますね。

ソースコードの絶対パスは先ほど調べた rustup home に .rustup\\toolchains 、そして toolchain名、末尾に lib\\rustlib\\src\\rust を連結しています。

ここまでの説明を図にするとこうなります。

筆者の環境は日本語Windowsなのでファイルパスの区切り文字はエンサインです。そのままJSONに書いてしまうと期待通りの値にならないので、エンサインを重ねてエスケープしています。

ここまで設定したら、ソースコード上に表示された Debug をクリックしてデバッグ実行できます。

デバッグビューからの起動にソースコードをアタッチする方法

CodeLLDBにはデバッグを開始する方法が二つ用意されています。一つ目は、既に説明した方法です。これから説明するのは、VS Codeのデバッグビューから実行する方法です。

まずは、CodeLLDBの機能を使ってlaunch.jsonを自動生成しましょう。この Run and Debug ボタンを押すとモーダルダイアログが2回程出力されますので、それぞれOKとYesを押してください。

出力されたlaunch.jsonの中から説明に必要な部分だけを抜粋したのが、以下のJSONです。

{
  "type": "lldb",
  "request": "launch",
  "name": "Debug executable 'learn-rust'",
  "cargo": {
    "args": [
      "build",
      "--bin=learn-rust",
      "--package=learn-rust"
    ],
    "filter": {
      "name": "learn-rust",
      "kind": "bin"
    }
  },
  "args": [],
  "cwd": "${workspaceFolder}"
}

ワークスペースのルートディレクトリにあるCargo.tomlの内容次第で詳細は違うでしょうが、似たようなファイルが作成されれているはずです。

このJSONにsourceMap というキーで先ほど設定したのと同じ値を設定したものがこれです。

{
      "type": "lldb",
      "request": "launch",
      "name": "Debug executable 'learn-rust'",
      "cargo": {
        "args": ["build", "--bin=learn-rust", "--package=learn-rust"],
        "filter": {
          "name": "learn-rust",
          "kind": "bin"
        }
      },
      "args": [],
      "cwd": "${workspaceFolder}",
      "sourceMap": {
        "/rustc/f1edd0429582dd29cccacaf50fd134b05593bd9c": "C:\\Users\\taichi\\scoop\\persist\\rustup-msvc\\.rustup\\toolchains\\stable-x86_64-pc-windows-msvc\\lib\\rustlib\\src\\rust"
      }
    }