開発環境:Visual Studio Code

軽量エディタ VSCode で C# プログラムを作成する環境を整えましょう

Visual Studio Code とは

VSCode の特徴

Visual Studio Code(VSCode)は、Microsoft が開発した無料・オープンソースの軽量コードエディタです。Windows・macOS・Linux のすべてに対応しており、C# に限らず多くのプログラミング言語で利用されています。

VisualStudio(フル IDE)と名前が似ていますが、VSCode はよりシンプルで起動が速く、拡張機能を追加することで自分好みの開発環境を構築できるのが特徴です。

C# で VSCode を使う場合に必要なもの

VSCode 単体では C# のビルド・実行はできません。以下の 3 つをそろえる必要があります。

  1. Visual Studio Code(エディタ本体)
  2. .NET SDK(C# のビルド・実行環境)
  3. C# Dev Kit 拡張機能(VSCode 上でのコード補完・デバッグ支援)
💡 このサイトのサンプルコードは .NET Framework 向けに書かれていますが、VSCode では .NET(旧 .NET Core) を使用します。基本的な文法・Console の使い方は同じですが、プロジェクト構成がやや異なります。

インストール

手順1:Visual Studio Code のインストール

以下の公式サイトから VSCode をダウンロードしてインストールします。

VSCode 公式サイト:https://code.visualstudio.com/

ページを開いたら「Download for Windows」(または対応 OS)ボタンをクリックし、ダウンロードされたインストーラーを実行します。インストールオプションはデフォルトのまま「次へ」を進めれば問題ありません。

⚠️ インストール時に「PATH への追加」「エクスプローラーのコンテキストメニューに追加」にチェックを入れておくと、後から便利に使えます。

手順2:.NET SDK のインストール

C# のビルド・実行には .NET SDK が必要です。以下の公式サイトからダウンロードしてインストールします。

.NET 公式サイト:https://dotnet.microsoft.com/ja-jp/download

ページを開いたら最新の .NET SDK(「推奨バージョン」と表示されているもの)をダウンロードし、インストーラーを実行します。インストール完了後、コマンドプロンプト(またはターミナル)で以下のコマンドを実行してバージョンが表示されれば成功です。

ターミナル
dotnet --version
💡 バージョン番号(例:8.0.100)が表示されれば、.NET SDK が正しくインストールされています。「コマンドが見つかりません」と表示された場合は PC を再起動してから再度お試しください。

手順3:C# Dev Kit 拡張機能のインストール

VSCode を起動し、左側のアクティビティバーにある「拡張機能」アイコン(四角が4つ並んだアイコン)をクリックします。検索窓に 「C# Dev Kit」 と入力し、表示された「C# Dev Kit(Microsoft 製)」の「インストール」ボタンをクリックします。

インストールが完了すると、あわせて「C#」拡張機能も自動的にインストールされます。これにより、コード補完(IntelliSense)・エラー検出・デバッグ機能が利用できるようになります。

⚠️ C# Dev Kit の利用には Microsoft アカウントへのサインインが必要な場合があります。VSCode のサインインプロンプトに従って Microsoft アカウントでサインインしてください。

プロジェクトの作成

ターミナルを使ったプロジェクト作成

VSCode でのプロジェクト作成は、ターミナル(コマンドライン)を使って行います。VSCode のメニューから「ターミナル(T)」→「新しいターミナル」を選択するか、ショートカット Ctrl + @(Backtick)でターミナルを開きます。

Step 1

プロジェクトを作成したいフォルダに移動します。

ターミナル
cd C:\Users\YourName\Projects
Step 2

以下のコマンドでコンソールアプリのプロジェクトを作成します。Sample101 の部分はプロジェクト名です。

ターミナル
dotnet new console -n Sample101

コマンドを実行すると、Sample101 フォルダが作成され、中に Program.cs(ソースファイル)と Sample101.csproj(プロジェクト設定ファイル)が生成されます。

Step 3

作成したフォルダを VSCode で開きます。

ターミナル
cd Sample101
code .

VSCode が起動し、Sample101 フォルダが開きます。左側のエクスプローラーに Program.csSample101.csproj が表示されていれば準備完了です。

💡 VSCode のメニューから「ファイル(F)」→「フォルダーを開く...」でフォルダを選択しても同様に開けます。

ソースコードの入力

Program.cs の初期状態

プロジェクト作成直後の Program.cs は、.NET 6 以降では次のような「トップレベルステートメント」形式で生成されます。

Program.cs(.NET 6 以降の初期状態)
// See https://aka.ms/new-console-template for more information
Console.WriteLine("Hello, World!");

このサイトのサンプルコードは namespaceclass Program を明示した従来の書き方で記述されています。従来形式で書く場合は、Program.cs の内容を全て削除してサンプルコードをそのまま貼り付けてください。

Program.cs(サンプルコードに書き直した例)
using System;

namespace Sample101
{
    class Program
    {
        static void Main(string[] args)
        {
            Console.WriteLine("HelloWorld.");
        }
    }
}

IntelliSense によるコード補完

C# Dev Kit が有効になっていると、コードを入力する際にIntelliSense(コード補完)が機能します。例えば Console. まで入力すると、利用できるメソッド一覧が表示され、キーボードの矢印キーで選択して Tab または Enter で確定できます。

💡 赤い波線(エラーの下線)が表示された場合は、その箇所にマウスカーソルを合わせるとエラーの説明が表示されます。コードを修正してエラーが消えてから実行してください。

プログラムの実行

ターミナルから実行する

VSCode のターミナルで以下のコマンドを実行します。ビルドと実行が同時に行われ、結果がターミナルに表示されます。

ターミナル
dotnet run

プログラムが正常に実行されると、ターミナルに出力結果が表示されます。

実行結果の例
HelloWorld.
⚠️ dotnet run はプロジェクトのフォルダ(Sample101 など、.csproj ファイルがあるフォルダ)内で実行してください。別のフォルダにいる場合は cd Sample101 で移動してから実行します。

デバッグ実行(F5)

キーボードの F5 キーを押すと、デバッグモードでプログラムを実行できます。初回実行時は構成の選択を求められるので、「C#」を選択してください。

デバッグモードでは、ソースコードの行番号左側をクリックしてブレークポイントを設定すると、その行でプログラムの実行を一時停止させることができます。変数の値を確認しながら、プログラムの動作を追いやすくなります。

💡 デバッグなしで実行する場合は Ctrl + F5、またはターミナルから dotnet run を使用してください。

ビルドエラーが出た場合

ソースコードに誤りがある場合、dotnet run を実行するとターミナルにエラーメッセージとエラーが発生した行番号が表示されます。メッセージを確認して該当箇所を修正し、再度 dotnet run を実行してください。

エラーが出た場合の表示例
Build FAILED.

Program.cs(9,13): error CS1002: ; expected [/Sample101/Sample101.csproj]

上記の例では Program.cs9行目 に文法エラー(セミコロンが抜けている)があることを示しています。行番号と内容を参考に修正してください。