本記事は、 Rust Advent Calendar 2024 4日目 の記事だ。Windows Advent Calendar 2024 4日目 の記事としても登録させてもらっている。
どちらもまだ空きが在るので是非登録してね！
Rust Advent Calendar 2024 シリーズ 2 の 3日目 の記事は、 @yo-naka 氏の Observable Framework のデータローダーを Rust で書く方法 #ObservableFramework 。
さて4日目の本記事は、プロキシ環境下にて Windows + vscode + Rust Analyzer の組み合わせで使用しようとしたところ、標準ライブラリ等のコード補完が期待通り動いてくれなかった問題の対処メモだ。
ついでに、プロキシ環境下のセットアップ手順も示す。
再現手順
とりあえず、まずプロキシ環境下でセットアップしてみよう。Windows - The rustup book の手順をベースにしている。
1) Build Tools for Visual Studio をインストール
Visual Studio の何らかのライセンス対象の場合 は、 Build Tools for Visual Studio をインストールする。Visual Studio Installer
最低限、個別のコンポーネントで MSVC v14* - VS 20** C++ x64/x86 ビルド ツール (最新) と、 Windows 1* SDK をインストールしよう。
公式の手順では Visual Studio 2022 (MSVC v143) をインストールしているが、サポート期間が残っている Visual Studio 2017 (MSVC v141) などでも良いようだ。
Visual Studio のライセンスについて、少し補足をば。
プロキシの環境下にあるようなユーザーは、おそらく何らかの組織に所属しているような人だろう。
ビルドツールのライセンス条項 によると、 OSS の依存関係の中でビルドする場合を除くと、 Community, Professional, Enterprise のいずれかの Visual Studio ライセンスが必要だ。
個人開発者なら Community のライセンスが使えるものの、 250人 or 250台のPC or 収益 $100万 のいずれかを超える会社に所属したり、その下請けとして利用する場合など、「エンタープライズ利用」と分類される場合は、基本的に Professional, Enterprise が必要となる。
もし、 Visual Studio のライセンスが使えない場合、この手順はスキップして (2.5) の手順で rust の toolchain を stable-gnu に設定しよう。（後述）
2) rustup で Rust をインストール
Rust のインストールには Rustup を使おう。
PowerShell を起動し、以下を実行する。http_proxy, https_proxy 変数に設定するプロキシのアドレスは、環境にあわせて書き換える（以下同）。
$env:http_proxy = $env:https_proxy = 'http://proxy.example.com:8080';
winget install --id Rustlang.Rustup;自動的に staube-msvc のツールチェインや、主要なコンポーネントがインストールされる
2.5) ツールチェインを stable-gnu に切り替える
(1) で Build Tools for Visual Studio をインストールしなかった 人向け。 この項を実行せず (3) にスキップ。
改めて PowerShell を起動し直し、以下を実行する。
# Visual Studio をインストールしなかった人のみ
$env:http_proxy = $env:https_proxy = 'http://proxy.example.com:8080';
rustup toolchain install stable-gnu;
rustup default stable-gnu;3) vscode のセットアップ
vscode のインストールと、プロキシ回りの設定をしておく。
Microsoft の Visual Studio Code のサイト から vscode をインストールvscode 上部のコマンドパレットで > Open user settings (json) と入力して settings.json を開き、以下の JSON 構造を追記。
{
"http.proxy": "http://proxy.example.com:8080",
"terminal.integrated.profiles.windows": {
"PowerShell": {
"source": "PowerShell",
"icon": "terminal-powershell",
"env": {
"https_proxy": "http://proxy.example.com:8080",
},
},
},
}
既に何らかの設定が入っていたら、 JSON 構造的にうまくマージしてくれ。
vscode を立ち上げ直し、任意の（空の）フォルダを開く
vscode の拡張機能で rust-analyzer をインストール
コード補完が効かない問題の発生
さて、コレで環境が整ったはず。
vscode のターミナル上で cargo init などと入力し、任意の Rust プロジェクトを作成する
適当に main.rs のソースを書いてみる。
#[derive(Debug)]
struct Location(i32, i32);
fn main() {
println!("Hello, world!");
let loc = Location(42, 42);
let mut tvec = Vec::new();
tvec.push(1);
tvec.push(2);
println!("{:?} {:?}", loc, tvec);
}
ターミナルでビルドと実行してみる。 cargo build cargo run
ところが、コード内で定義した型 (Location 構造体) の型推論は動いているのに、 標準ライブラリ (Vec::new) を使った方は型推論もされず {unknown} となることに加えコード補完も動かない。
うーん…
原因
エラーメッセージ上は、 {sysroot_path} の設定 (vscode の設定上の rust-analyzer.cargo.sysroot など) に rustc --print sysroot で出力した内容を記述すればうまく動きそうだが、それは上手く行かない。
そもそもの原因は単純で、 rust-analyzer がプロキシの設定を読めていない為だ。
vscode は以下の 3箇所 でプロキシの設定がある。
vscode 本体 (拡張機能のインストールなど) は、 OS のプロキシ設定を読む
vscode の拡張機能などは（本来）、 vscode の設定の http.proxy を読む
vscode のターミナルは、 vscode の設定の terminal.integrated.profiles.windows.*.env を読む
本来 rust-analyzer は (2) のプロキシ設定を解釈すべきなのだが、どうも無視してしまうようだ。
厳密には、 非HTTP 通信には適用されているものの、 HTTPS 通信には適用されないため、 HTTPS で配信されているコンポーネントやクレートが落とせないのが問題なようだ。
対策
vscode プロセスそのものの環境変数に https_proxy を設定すれば、解消する。
方法1:
Windows 側のシステムまたはユーザーの環境変数に、上記値を設定する。
多分これが一番手っ取り早いのでオススメ。
但しすべてのアプリに影響してしまうので、場合によっては他のイントラネットアプリが動かなくなってしまうこともあるだろう。
方法2:
一回だけ vscode を立ち上げる際に、プロセス環境を設定する。
具体的には、 PowerShell 上で一時的な環境変数を設定し、カレントディレクトリを移動したあと、 code . で vscode を立ち上げる。
$env:https_proxy = 'http://proxy.example.com:8080';
cd 'path\to\project_dir';
code .;一度上記環境で vscode の rust-analyze が起動すれば、標準ライブラリのコード補完に必要なコンポーネントやクレートはダウンロードされる。
但し、 Cargo.toml を書き換えて依存クレートが変更されると、変更後の依存関係の情報の更新に失敗するので、そのときはまた環境変数を設定した vscode に立ち上げ直す必要がある。
対策後
上記いずれかの対策を行って、 rust-analyze 内部の Cargo のモジュール解決が済めば、以下のように正しく型推論やコード補完が実行されるようになるはずだ。
