WSL2でLinuxネイティブ版Antigravityを正しく動かす
🎯 はじめに:結論から
この記事は、以下の目的を持った人に向けて書きました。
「Ubuntu 22.04 (WSL2) で、Windows版経由ではなく、純粋な Linux ネイティブ版として Antigravity を動かしたい」
私がこの環境構築でドハマリし、最終的にたどり着いた結論は以下の通りです。
- apt / deb 版は罠:WSL環境を検知すると「Windows版を使え」と警告するラッパーになっている。
-
Windows版が邪魔をする:WSLの仕様により、Windows側にインストールされた
Antigravity.exeがantigravityコマンドとして Linux 側の PATH に割り込み、ネイティブ版より優先されてしまう。 -
tar.gz 版が唯一の正解:公式サイトの tarball を
/optに配置し、手動でパスを通すことでのみ純粋なLinux環境として動作する。
本記事では、この結論に至るまでの挙動の解析と、再現性100%の構築手順を共有します。
📌 検証環境
今回の検証は、以下の最新ミドル〜ハイエンド構成で行いました。
- OS: Windows 11 Pro
- WSL2: Ubuntu 22.04 LTS
- CPU: AMD Ryzen 7 9800X3D (8-Core / 16-Thread, L3 Cache 96MB)
- RAM: 32GB (DDR5-5600)
- GPU: NVIDIA GeForce RTX 5070 Ti (VRAM 16GB)
-
Storage:
-
/home/user(WSL仮想ディスク / 高速) -
/mnt/c(Windows側 NTFS / 低速)
-
- 対象アプリ: Antigravity (Electron/Chromiumベース)
🧨 発生した4つの「詰み」ポイント
WSL上で普通に sudo apt install をしたり、公式サイトからインストーラーを落とすだけでは、以下の問題が発生します。
💥 問題1:apt版が「Windows版を使え」と命令してくる
apt でインストールした Linux 版を起動しようとすると、以下のメッセージが出て終了します。
To use Antigravity with the Windows Subsystem for Linux,
please install Antigravity in Windows and uninstall the Linux version in WSL.
実はこれ、**Antigravity 本体ではなく、WSL環境であることを検知するためのシェルスクリプト(ラッパー)**が起動しています。Debianパッケージ版は、WSL上ではあえて動かないように設計されているのです。
💥 問題2:apt remove しても「亡霊」が残る
「じゃあ apt 版は消そう」と apt purge しても、コマンドラインで antigravity と打つと何かが起動しようとします。これは WSL の Interop 機能 が自動生成した /bin/antigravity というファイル(shim)が残っているためです。
💥 問題3:Windows版 EXE が Linux コマンドになりすます
これが最大のパフォーマンス低下の原因です。WSL はデフォルトで Windows の PATH を引き継ぐため、以下の現象が起きます。
$ which -a antigravity
/usr/local/bin/antigravity # 本来動かしたいLinux版(優先度低)
/bin/antigravity # WSLが作った偽物(優先度高!)
/mnt/c/.../antigravity.exe # Windowsの実体
Linux 側で antigravity と打ったつもりが、裏では Windows 側の .exe が起動しています。
WSL から Windows の EXE を叩くと、ファイルシステムの境界を越えるため IO が激重になり、「Linux 版を入れたはずなのに遅い」という現象を引き起こします。
🚀 完全な解決手順(再現手順)
WSL の干渉を排除し、純粋な Linux バイナリとして動作させるための唯一の手順です。
Step 0: 既存の競合を完全削除
まずは apt 版や、中途半端な設定を掃除します。
# apt版の削除
sudo apt purge -y antigravity || true
sudo apt autoremove -y
# 手動で配置した可能性のあるゴミを削除
sudo rm -f /usr/bin/antigravity /usr/local/bin/antigravity
# ハッシュキャッシュをクリア(重要)
hash -r
Step 1: 公式サイトから tar.gz 版を入手
公式サイトから、.deb ではなく .tar.gz (Linux x64) 版をダウンロードしてください。
Windows 側でダウンロードしたファイルを、WSL 側のホームディレクトリ(ext4領域)にコピーします。
※ /mnt/c 上で解凍するとパーミッションがおかしくなるため、必ず WSL のホーム以下で作業してください。
cd ~
# 例: WindowsのDownloadsから持ってくる
cp /mnt/c/Users/yourname/Downloads/Antigravity-linux-x64.tar.gz .
Step 2: /opt への配置(Linuxの流儀)
tar.gz を解凍し、/opt ディレクトリへ配置します。
# 以前の残骸があれば消す
sudo rm -rf /opt/antigravity
# 解凍して移動
tar -xzf Antigravity-linux-x64.tar.gz
sudo mv Antigravity /opt/antigravity
# 実行権限の確認
sudo chmod -R 755 /opt/antigravity
Step 3: 優先度を考慮したシンボリックリンク作成
ここが最重要です。WSL の shim (/bin/antigravity) よりも優先される場所、つまり /usr/local/bin にリンクを貼ります。
sudo ln -sf /opt/antigravity/bin/antigravity /usr/local/bin/antigravity
確認のため、以下のコマンドを打ちます。
hash -r
which -a antigravity
期待される出力:
/usr/local/bin/antigravity <-- これが一番上にあればOK
/bin/antigravity <-- Windows版へのshim(無視される)
/usr/bin/antigravity <-- apt版(存在してはいけない)
Step 4: 依存関係の解決(Electron系あるある)
Antigravity は Electron (Chromium) ベースであるため、起動時にライブラリ不足のエラー(error while loading shared libraries: libnss3.so など)が出ることがあります。
必要なライブラリをまとめて入れます。
sudo apt update
sudo apt install -y \
libnss3 \
libatk1.0-0 \
libatk-bridge2.0-0 \
libasound2 \
libgtk-3-0 \
libxss1 \
libgbm1 \
libdrm2 \
libxdamage1 \
libxrandr2 \
libxkbcommon0
Step 5: 起動確認
antigravity
これで「Windows版を使え」という警告が出ず、GUI アプリケーションとして起動すれば成功です!
🧩 技術的な深掘り:なぜこんなことが起きるのか?
なぜ apt 版はわざわざ使いにくくなっているのでしょうか?
そして、なぜ Windows 版が勝手に優先されるのでしょうか?
1. 開発元の推奨構成
Google等の開発元が推奨する構成は以下の通りです。
- GUI アプリ: Windows 側にインストール
- 実行環境: WSL Remote で接続
VS Code と同様、Antigravity も「Windows アプリから WSL に接続する」というアーキテクチャが公式推奨です。そのため、apt パッケージには「WSL で実行されたら、ユーザーに Windows 版を使うよう誘導する」スクリプトが仕込まれています。
2. WSL の Interop 機能の副作用
WSL は利便性のため、/init プロセスが Windows の PATH 環境変数を Linux 側にインポートし、さらに binfmt_misc を使って Windows バイナリを実行可能にします。
🏁 まとめ
WSL2 で「なんか Linux 版のツールが遅い」「Windows 版を使えと怒られる」という現象に出会ったら、以下を疑ってください。
- apt / deb パッケージが WSL 対策されたラッパーではないか?
which -a コマンド名で、Windows 側の EXE が優先されていないか?
解決策はシンプル。「tar.gz 版を /opt に入れ、/usr/local/bin にリンクを貼る」。
これで快適な Linux ネイティブ開発環境が手に入ります。
Discussion