UbuntuでVisual Studio Code（VS Code）を使おうとして「なぜかうまく動かない」「拡張機能を入れたのに実行できない」といった問題に直面することがあります。特にRun C/C++などの拡張を入れている場合、設定や環境の違いが原因になっているケースが多いです。本記事ではUbuntu環境でVS Codeが正常に動かないときの代表的な原因と対処方法を整理します。
VS CodeがUbuntuでうまく動かない主な原因
UbuntuでVS Codeが動作しない場合、多くはインストール方法や依存関係、パス設定の問題です。
例えばSnap版とdeb版の混在、PATHが通っていない、または拡張機能のビルド環境不足などがよくある原因です。
① インストール方法（Snap版・deb版）の違いを確認
UbuntuではVS CodeをSnap版で入れる方法と、公式debパッケージで入れる方法があります。
Snap版では一部の拡張機能が制限されることがあり、特にファイルアクセスや外部コマンド実行で問題が起きることがあります。
不具合がある場合はdeb版への切り替えを検討すると改善することがあります。
② C/C++拡張（Run C/C++）の設定不足
「code run / C extension」を入れている場合でも、gccやg++などのコンパイラが未インストールだと実行できません。
Ubuntuでは以下のコマンドで基本開発環境を入れる必要があります：
sudo apt install build-essential
これによりコンパイル環境が整い、VS Codeからコード実行が可能になります。
③ PATH・コマンド認識エラー
ターミナルから「code」コマンドが動かない場合、PATH設定が正しくありません。
VS Code内から「Shell Command: Install ‘code’ command in PATH」を実行することで解決できます。
また拡張機能が内部コマンドを呼べない場合も同様の原因であることが多いです。
④ 拡張機能の競合や不具合
複数の拡張機能が競合していると、実行ボタンが反応しないことがあります。
特にCode RunnerとC/C++拡張を同時に使っている場合は設定の重複に注意が必要です。
一度拡張機能を無効化して原因を切り分けると改善しやすくなります。
⑤ 権限・実行環境の問題
Ubuntuではファイルの実行権限が原因でコードが動かないケースもあります。
実行ファイルに対してchmod +xを設定する、または作業フォルダの権限を確認することが重要です。
特にホームディレクトリ外で作業している場合は注意が必要です。
まとめ
UbuntuでVS Codeがうまく動かない場合は、インストール方法・拡張機能・コンパイラ環境・PATH設定のいずれかに原因があることがほとんどです。
特にC/C++実行環境ではbuild-essentialの不足がよくある原因です。
一つずつ原因を切り分けることで、多くの問題は解決できます。
コメント