C#環境構築ガイド｜初心者が最短で開発を始めるためのVisual Studio・VS Code・.NET設定手順
はじめに
C#でプログラミングを始めるとき、最初につまずきやすいのが「C#環境」の準備です。C#そのものはプログラミング言語ですが、実際にコードを書いて実行するには、エディタやIDE、.NET SDK、実行環境などを正しくそろえる必要があります。
C#は、コンソールアプリ、Windowsデスクトップアプリ、Webアプリ、API、ゲーム、スマホアプリなど幅広い開発に使える言語です。そのため、目的によって最適な環境構成が少し変わります。
この記事では、初心者が最短でC#開発を始められるように、Visual Studio、Visual Studio Code、.NET SDKの違いから、Windows・Macでの具体的な環境構築手順、よくあるエラーの解決方法まで順番に解説します。
1. C#環境構築で最初に知っておくべきこと
C#環境構築では、いきなりインストール作業を始める前に「何を入れる必要があるのか」を理解しておくと迷いにくくなります。
C#の開発では、コードを書くためのツール、C#をビルドするための仕組み、作ったアプリを実行するための仕組みが必要です。これらをまとめて準備することが、C#環境を作るということです。
1-1. C#の開発環境に必要なものは「エディタ・.NET SDK・実行環境」
C#環境に必要な基本要素は、主に次の3つです。
1つ目は、コードを書くためのエディタまたはIDEです。代表的なものにVisual StudioとVisual Studio Codeがあります。Visual Studioは機能が豊富な統合開発環境で、VS Codeは軽量なコードエディタです。
2つ目は、.NET SDKです。C#のコードを作成、ビルド、実行するために必要な開発用ツール一式です。
3つ目は、.NET Runtimeです。これは作成済みの.NETアプリを実行するための仕組みです。開発する場合はRuntimeだけでは足りず、基本的にはSDKをインストールします。
つまり、初心者がC#環境を作るなら、まずは「Visual StudioまたはVS Code」と「.NET SDK」を準備する、と考えれば問題ありません。
1-2. .NET SDKと.NET Runtimeの違い
.NET SDKと.NET Runtimeは名前が似ていますが、役割が違います。
.NET Runtimeは、完成した.NETアプリを動かすための実行環境です。一方、.NET SDKはアプリを作成するための開発環境で、Runtimeに加えて、コンパイラ、ビルドツール、CLIコマンドなどが含まれます。Microsoftの公式ドキュメントでも、Runtimeは.NETアプリを実行するもの、SDKはアプリを作成するためのものと説明されています。
初心者がC#を学習する場合は、必ず.NET SDKをインストールしましょう。Runtimeだけを入れても、dotnet newやdotnet buildなどの開発用コマンドが使えないため、プロジェクト作成やビルドができません。
確認コマンドは次のとおりです。
Bashdotnet --version
SDKが正しく入っていれば、インストール済みの.NET SDKのバージョンが表示されます。
1-3. 初心者はVisual StudioとVS Codeのどちらを選ぶべきか
C#初心者が迷った場合、WindowsならVisual Studioがおすすめです。理由は、インストーラーで必要な機能をまとめて入れやすく、プロジェクト作成、ビルド、実行、デバッグまで画面操作で完結しやすいからです。
一方、MacやLinuxでC#を始めたい場合や、軽いエディタで学習したい場合はVS Codeが向いています。VS CodeにC#拡張機能を追加し、.NET SDKをインストールすれば、C#開発を始められます。
初心者の選び方はシンプルです。
Windowsでしっかり学びたいならVisual Studio、Macや軽量環境で始めたいならVS Code、ゲーム開発が目的ならUnityと組み合わせる、という考え方で選ぶとよいでしょう。
1-4. Windows・Mac・LinuxでC#環境構築の手順は変わるのか
C#はWindows専用の言語ではありません。.NETは無料のオープンソースでクロスプラットフォームの開発者向けプラットフォームであり、Windows、Linux、macOSで利用できます。
ただし、OSによって使いやすい開発ツールは変わります。
WindowsではVisual Studioが最も手軽です。特にWindowsデスクトップアプリを作りたい場合、Visual Studioの「.NETデスクトップ開発」ワークロードを使うと環境構築が簡単です。
Macでは、Visual Studio for Macが2024年8月31日にサポート終了しているため、現在はVS Code、JetBrains Rider、またはコマンドライン中心の開発が現実的です。
Linuxでは、VS Codeと.NET SDKを組み合わせる方法が一般的です。WebアプリやAPI、コンソールアプリの開発であれば、Windows以外でも十分にC#開発ができます。
2. C#開発環境の選び方｜Visual Studio・VS Code・その他の違い
C#環境構築で大切なのは、「どのツールが一番有名か」ではなく、「自分の目的に合っているか」です。
同じC#でも、コンソールアプリを作るのか、Windowsアプリを作るのか、Web APIを作るのか、Unityでゲームを作るのかによって、選ぶべき環境は変わります。
2-1. Visual Studioが向いている人
Visual Studioは、C#開発に必要な機能が最初からまとまっている本格的なIDEです。WindowsでC#を学び始める初心者には特に向いています。
Visual Studioが向いているのは、次のような人です。
画面操作でプロジェクトを作成したい人、デバッグを簡単に使いたい人、Windowsデスクトップアプリを作りたい人、C#や.NETを本格的に学びたい人にはVisual Studioが適しています。
特に、WinForms、WPF、Windowsデスクトップアプリ、ASP.NET Core、Entity Frameworkなどを学ぶ場合、Visual Studioの補完、デザイナー、デバッグ機能が役立ちます。
また、Visual Studio Communityは個人開発や学習用途で使いやすい無料のIDEとして提供されており、C#初心者にとって導入しやすい選択肢です。
2-2. VS Codeが向いている人
VS Codeは軽量で拡張性の高いコードエディタです。C#専用のIDEではありませんが、拡張機能と.NET SDKを組み合わせることでC#開発ができます。
VS Codeが向いているのは、MacやLinuxでC#を開発したい人、軽いエディタを使いたい人、ターミナル操作に慣れたい人、WebアプリやAPI開発を中心に学びたい人です。
VS Codeでは、dotnet new、dotnet build、dotnet runなどのコマンドを使って開発する場面が多くなります。そのため、最初は少し難しく感じるかもしれませんが、C#と.NET CLIの仕組みを理解しやすいというメリットもあります。
2-3. Visual Studio CodeでC#開発するメリット・デメリット
VS CodeでC#開発をするメリットは、軽くて起動が速いこと、Windows・Mac・Linuxで同じように使えること、拡張機能で必要な機能だけを追加できることです。
また、Web開発やクラウド開発では、VS Codeを使う場面も多くあります。ASP.NET Core、Docker、Git、Azure関連の拡張機能を組み合わせれば、実務に近い開発環境も作れます。
一方で、デメリットもあります。Visual Studioに比べると、GUI操作だけで完結しにくく、ターミナル操作が必要になる場面が多いです。また、Windowsデスクトップアプリの画面デザイナーなど、Visual Studioのほうが使いやすい機能もあります。
初心者がVS CodeでC#を始める場合は、まずコンソールアプリから始めるのがおすすめです。
2-4. Unity開発でC#を使う場合の環境構築の注意点
UnityでC#を使う場合、通常の.NETアプリ開発とは少し環境が異なります。
Unityでは、Unity Hubをインストールし、Unity Editorを追加し、外部スクリプトエディタとしてVisual StudioまたはVS Codeを設定します。Unity向けのC#コードは、通常のコンソールアプリとはプロジェクト構成や実行方法が違います。
たとえば、Unityではdotnet runでゲームを実行するのではなく、Unity Editor上で再生ボタンを押して動作確認します。また、Unityのバージョンによって対応するC#の言語機能や.NET相当のAPIに差がある場合があります。
Unity目的でC#環境を作る場合は、「.NET SDKを入れれば終わり」ではなく、「Unity Hub」「Unity Editor」「エディタ連携」の3つを確認しましょう。
2-5. 初心者におすすめのC#環境構成
初心者におすすめのC#環境構成は、目的別に分けるとわかりやすいです。
WindowsでC#を学習するなら、Visual Studio Communityと.NETデスクトップ開発ワークロードを入れる構成がおすすめです。インストール後すぐにプロジェクトを作成し、実行やデバッグを試せます。
MacでC#を学習するなら、VS Code、.NET SDK、C#拡張機能の組み合わせがおすすめです。Visual Studio for Macはサポート終了しているため、現在はVS Codeを中心に考えるとよいでしょう。
WebアプリやAPIを作りたい場合も、VS Codeと.NET SDKで始められます。より本格的に開発したい場合は、WindowsならVisual Studio、MacならJetBrains Riderなども選択肢になります。
3. WindowsでC#環境を構築する手順
WindowsでC#環境を構築するなら、最も簡単なのはVisual Studioを使う方法です。Visual Studioをインストールすると、C#開発に必要な機能をワークロード単位でまとめて追加できます。
ここでは、WindowsでVisual Studioを使ってC#環境を作る手順を解説します。
3-1. Visual Studioをインストールする
まず、Visual Studioの公式サイトからVisual Studio Communityをダウンロードします。
学習や個人開発であれば、基本的にはCommunity版で十分です。インストーラーを起動すると、必要な開発機能を選択する画面が表示されます。
Visual Studioは容量が大きいため、インストールにはある程度の空き容量と時間が必要です。途中でエラーが出ないように、PCの空き容量を確認し、可能であれば安定したネットワーク環境で作業しましょう。
3-2. 「.NETデスクトップ開発」ワークロードを選択する
インストーラーが表示されたら、ワークロード選択画面で「.NETデスクトップ開発」を選びます。
このワークロードには、C#でWindowsデスクトップアプリを作るために必要な機能が含まれています。コンソールアプリの学習にも使えるため、初心者はまずこれを選んでおくと安心です。
WebアプリやAPIも作りたい場合は、「ASP.NETとWeb開発」も追加しておくとよいでしょう。ただし、最初から多くのワークロードを入れると容量が大きくなるため、まずは必要最低限で始め、あとから追加しても問題ありません。
3-3. .NET SDKが入っているか確認する
Visual Studioのインストールが終わったら、.NET SDKが使えるか確認します。
Windowsのスタートメニューから「ターミナル」または「コマンドプロンプト」を開き、次のコマンドを実行します。
Bashdotnet --version
バージョン番号が表示されれば、.NET SDKが利用できる状態です。
さらに詳しく確認したい場合は、次のコマンドを実行します。
Bashdotnet --list-sdks
インストール済みのSDK一覧が表示されます。
「dotnetは内部コマンドまたは外部コマンドとして認識されていません」と表示される場合は、SDKが入っていない、またはPATHが正しく設定されていない可能性があります。
3-4. C#の新規プロジェクトを作成する
Visual Studioを起動し、「新しいプロジェクトの作成」をクリックします。
検索欄に「コンソール」と入力し、「コンソール アプリ」を選びます。言語がC#になっていることを確認してから次に進みます。
プロジェクト名は、最初は次のようなわかりやすい名前にするとよいでしょう。
HelloCSharp
保存場所には、日本語や記号を含まない短いパスを選ぶとトラブルを避けやすくなります。たとえば、次のような場所がおすすめです。
C:\Projects\HelloCSharp
作成ボタンを押すと、C#の基本的なプロジェクトが自動生成されます。
3-5. Hello Worldを実行して動作確認する
プロジェクトが作成されたら、Program.csを開きます。テンプレートによっては、次のようなコードが最初から書かれています。
C#Console.WriteLine("Hello, World!");
Visual Studio上部の実行ボタンを押すと、プログラムがビルドされ、実行されます。
画面に「Hello, World!」と表示されれば、C#環境構築は成功です。
最初の段階では、難しいコードを書く必要はありません。まずは「プロジェクトを作る」「実行する」「結果を見る」という流れを体験することが大切です。
4. VS CodeでC#環境を構築する手順
VS CodeでC#環境を作る場合は、Visual Studioのようにすべてが最初から入っているわけではありません。
基本の流れは、VS Codeを入れる、.NET SDKを入れる、C#拡張機能を入れる、ターミナルでプロジェクトを作る、という順番です。
4-1. VS Codeをインストールする
まず、Visual Studio Codeの公式サイトからVS Codeをダウンロードしてインストールします。
VS CodeはWindows、Mac、Linuxで利用できます。.NET公式サイトでも、VS CodeはWindows、macOS、Linuxで使える開発ツールとして案内されており、C#開発ではC# Dev Kitなどの拡張機能を追加して利用します。
インストール時に、Windowsでは「PATHに追加する」「エクスプローラーのコンテキストメニューに追加する」などのオプションを有効にしておくと便利です。
4-2. .NET SDKをインストールする
次に、.NET SDKをインストールします。
.NETの公式ダウンロードページから、自分のOSに合ったSDKを選びます。C#を開発する場合はRuntimeではなくSDKを選んでください。
インストール後、ターミナルを開いて次のコマンドを実行します。
Bashdotnet --version
バージョン番号が表示されれば成功です。
表示されない場合は、ターミナルを再起動する、PCを再起動する、インストール先がPATHに追加されているか確認する、といった対応を行います。
4-3. C#拡張機能を追加する
VS Codeを起動し、左側の拡張機能アイコンをクリックします。
検索欄で次のように検索します。
C#
C#開発では、Microsoftが提供するC#関連の拡張機能やC# Dev Kitを追加します。補完、定義ジャンプ、エラー表示、デバッグ支援などが使えるようになります。
拡張機能をインストールしたら、VS Codeを再起動しておくと安定します。
4-4. ターミナルでC#プロジェクトを作成する
VS Codeで任意の作業フォルダを開き、ターミナルを表示します。
WindowsならPowerShell、Macならターミナル、Linuxならシェルを使います。
まず、プロジェクト用のフォルダを作ります。
Bashmkdir HelloCSharp
cd HelloCSharp
次に、コンソールアプリのプロジェクトを作成します。
Bashdotnet new console
このコマンドを実行すると、C#のコンソールアプリに必要なファイルが作成されます。
主なファイルは次のとおりです。
Program.cs
HelloCSharp.csproj
Program.csにはC#のコードを書き、.csprojファイルにはプロジェクトの設定が記述されます。
4-5. dotnet runでC#プログラムを実行する
プロジェクトを作成したら、次のコマンドで実行します。
Bashdotnet run
正常に実行できれば、ターミナルに次のような出力が表示されます。
Hello, World!
dotnet runは、ビルドと実行をまとめて行う便利なコマンドです。初心者のうちは、コードを書き換えたらdotnet runで動作確認する流れを覚えましょう。
たとえば、Program.csを次のように変更します。
C#Console.WriteLine("C#環境構築が完了しました！");
再度実行します。
Bashdotnet run
変更したメッセージが表示されれば、C#の編集と実行ができています。
4-6. VS Codeでデバッグ実行できるようにする
VS Codeでは、ターミナル実行だけでなく、デバッグ実行もできます。
デバッグ実行を使うと、ブレークポイントを設定して、プログラムを途中で止めながら変数の中身を確認できます。
まず、Program.csの行番号の左側をクリックして赤い丸を付けます。これがブレークポイントです。
次に、実行とデバッグ画面を開き、C#のデバッグ構成を作成します。C# Dev Kitなどの拡張機能が入っていれば、プロジェクトを認識してデバッグ実行しやすくなります。
デバッグを開始すると、ブレークポイントの位置でプログラムが一時停止します。ここで変数の値を確認したり、1行ずつ実行したりできます。
初心者は、最初から複雑なデバッグ操作を覚える必要はありません。まずは「ブレークポイントを置く」「止める」「変数を見る」の3つを覚えましょう。
5. MacでC#環境を構築する手順
MacでもC#開発は可能です。ただし、Windowsと違ってVisual Studioを使う前提ではなく、VS Codeと.NET SDKを組み合わせる方法が中心になります。
5-1. MacでC#開発を始めるために必要なもの
MacでC#開発を始めるために必要なものは、主に次の3つです。
1つ目は、.NET SDKです。C#プロジェクトの作成、ビルド、実行に必要です。
2つ目は、VS Codeなどのエディタです。C#コードを書くために使います。
3つ目は、C#拡張機能です。補完やデバッグを使いやすくするために追加します。
MacでC#を学習する場合、最初はコンソールアプリやWeb APIから始めるのがおすすめです。Windows専用のWinFormsやWPFはMacでの開発・実行に向いていないため、クロスプラットフォームな.NETアプリから始めるとスムーズです。
5-2. .NET SDKをインストールする
.NET公式サイトからmacOS用の.NET SDKをダウンロードします。
Apple Silicon搭載MacとIntel Macでは、選ぶインストーラーが異なる場合があります。自分のMacに合ったものを選びましょう。
インストール後、ターミナルで次のコマンドを実行します。
Bashdotnet --version
バージョン番号が表示されれば、SDKのインストールは完了です。
複数のSDKが入っているか確認する場合は、次のコマンドを使います。
Bashdotnet --list-sdks
5-3. VS CodeとC#拡張機能を設定する
次に、VS Codeをインストールします。
インストール後、拡張機能画面でC#またはC# Dev Kitを検索して追加します。インストールが終わったら、C#プロジェクトのフォルダをVS Codeで開きます。
Macでは、ターミナル操作とVS Codeを組み合わせる流れに慣れることが大切です。VS Code内のターミナルを使えば、エディタとコマンド操作を同じ画面で行えます。
5-4. ターミナルでC#プロジェクトを作成・実行する
Macのターミナルで、作業用フォルダを作ります。
Bashmkdir HelloCSharp
cd HelloCSharp
コンソールアプリを作成します。
Bashdotnet new console
作成したプロジェクトを実行します。
Bashdotnet run
次のように表示されれば成功です。
Hello, World!
VS Codeでこのフォルダを開くには、次のコマンドも使えます。
Bashcode .
ただし、codeコマンドが使えない場合は、VS Code側でShell Commandの設定が必要です。
5-5. MacでVisual Studioを使えない場合の代替方法
Visual Studio for Macはすでにサポート終了しているため、MacでC#開発をする場合は別の方法を選びます。
最も手軽なのは、VS Codeと.NET SDKを使う方法です。コンソールアプリ、ASP.NET Core、Web APIなどの開発であれば十分に対応できます。
より高機能なIDEを使いたい場合は、JetBrains Riderも選択肢になります。Riderは有料ですが、C#や.NET開発に強く、Macでも本格的なC#開発ができます。
Windows専用アプリを作りたい場合は、Mac上で直接開発するよりも、Windows PCや仮想環境、クラウド開発環境を使うほうが現実的です。
6. C#環境構築後に作成できるプロジェクトの種類
C#環境構築が終わると、さまざまな種類のアプリを作れるようになります。.NETはWeb、モバイル、デスクトップ、ゲーム、IoTなど幅広い用途に対応している開発プラットフォームです。
ここでは、代表的なプロジェクトの種類を紹介します。
6-1. コンソールアプリ
コンソールアプリは、ターミナルやコマンドプロンプト上で動くシンプルなアプリです。
C#初心者が最初に学ぶには最適です。画面設計やWebの知識が不要で、変数、条件分岐、繰り返し、配列、クラスなど、プログラミングの基礎に集中できます。
作成コマンドは次のとおりです。
Bashdotnet new console
実行コマンドは次のとおりです。
Bashdotnet run
C#の基礎を学ぶなら、まずはコンソールアプリから始めましょう。
6-2. Windowsデスクトップアプリ
Windowsデスクトップアプリは、Windows上で動くGUIアプリです。
C#では、WinForms、WPF、WinUIなどを使ってWindowsアプリを作成できます。業務システム、社内ツール、デスクトップ管理アプリなどで使われることがあります。
初心者がWindowsデスクトップアプリを作る場合は、Visual Studioを使うのがおすすめです。画面デザイナーを使ってボタンやテキストボックスを配置できるため、視覚的にアプリを作りやすくなります。
ただし、Windowsデスクトップアプリは基本的にWindows向けです。MacやLinuxでも動くアプリを作りたい場合は、Webアプリやクロスプラットフォーム対応の技術を検討しましょう。
6-3. Webアプリ・API開発
C#では、ASP.NET Coreを使ってWebアプリやWeb APIを作れます。
Webアプリは、ブラウザで操作するアプリです。Web APIは、フロントエンドやスマホアプリ、外部サービスとデータをやり取りするための仕組みです。
Web APIプロジェクトを作成する例は次のとおりです。
Bashdotnet new webapi
実行は次のコマンドです。
Bashdotnet run
ASP.NET CoreはWindowsだけでなく、MacやLinuxでも開発できます。そのため、VS Codeと.NET SDKの組み合わせとも相性がよいです。
6-4. ゲーム開発
C#でゲーム開発をする代表的な方法はUnityです。
Unityでは、ゲームオブジェクトの動き、当たり判定、UI操作、スコア管理などをC#で記述します。2Dゲーム、3Dゲーム、スマホゲーム、PCゲームなど幅広い開発ができます。
UnityでC#を使う場合は、通常の.NETプロジェクトとは違い、Unity Editor上でプロジェクトを作成します。C#ファイルはUnityのAssetsフォルダ内に作成し、ゲームオブジェクトにアタッチして使います。
C#の基本文法を理解してからUnityに進むと、スクリプトの意味がわかりやすくなります。
6-5. スマホアプリ開発
C#では、.NET MAUIを使ってスマホアプリを開発できます。
.NET MAUIは、C#でAndroid、iOS、Windows、macOS向けのアプリを作るためのフレームワークです。1つのコードベースで複数プラットフォームに対応できるのが特徴です。
ただし、スマホアプリ開発は環境構築がやや複雑です。Android SDK、iOS向けの設定、エミュレータ、証明書などが関係するため、C#初心者が最初に取り組むには少し難しい場合があります。
まずはコンソールアプリやWeb APIでC#に慣れてから、スマホアプリ開発に進むとよいでしょう。
7. C#環境構築でよくあるエラーと解決方法
C#環境構築では、インストール自体は完了しているのに、コマンドが動かない、補完が効かない、ビルドできないといった問題が起きることがあります。
ここでは、初心者がよく遭遇するエラーと解決方法を紹介します。
7-1. dotnetコマンドが認識されない
dotnet --versionを実行したときに、次のようなエラーが出ることがあります。
dotnet は、内部コマンドまたは外部コマンドとして認識されていません
この場合、主な原因は次のどれかです。
.NET SDKがインストールされていない、インストール後にターミナルを再起動していない、PATHが正しく設定されていない、Runtimeだけを入れてSDKを入れていない、という原因が考えられます。
まずは.NET SDKをインストールしたか確認しましょう。その後、ターミナルやVS Codeを再起動します。それでも解決しない場合は、PCを再起動してから再度確認します。
確認コマンドは次のとおりです。
Bashdotnet --info
7-2. .NET SDKが見つからない
dotnetコマンドは使えるのに、プロジェクト作成やビルド時にSDKが見つからないと表示されることがあります。
この場合、Runtimeだけが入っていてSDKが入っていない可能性があります。
次のコマンドでSDK一覧を確認します。
Bashdotnet --list-sdks
何も表示されない場合、SDKが入っていません。.NETの公式ダウンロードページからSDKをインストールしましょう。
また、プロジェクト内にglobal.jsonがある場合、指定されたSDKバージョンがPCに入っていないとエラーになることがあります。その場合は、global.jsonのバージョンを確認するか、指定されたSDKを追加でインストールします。
7-3. Visual Studioのワークロードを入れ忘れた
Visual StudioをインストールしたのにC#プロジェクトが作れない場合、必要なワークロードを入れていない可能性があります。
Visual Studio Installerを起動し、インストール済みのVisual Studioに対して「変更」を選びます。
C#の基本学習やWindowsアプリ開発なら、「.NETデスクトップ開発」を追加します。Webアプリを作りたい場合は、「ASP.NETとWeb開発」も追加します。
ワークロードを追加したあと、Visual Studioを再起動してプロジェクトテンプレートが表示されるか確認しましょう。
7-4. VS Codeで補完やデバッグが動かない
VS CodeでC#の補完やデバッグが動かない場合は、拡張機能、SDK、プロジェクト構成のいずれかに問題があることが多いです。
まず、C#関連の拡張機能が入っているか確認します。次に、ターミナルで次のコマンドを実行します。
Bashdotnet --version
SDKが認識されていない場合、VS Code側でもC#プロジェクトを正しく扱えません。
また、単独の.csファイルだけを開いている場合、補完やデバッグがうまく動かないことがあります。VS Codeでは、.csprojファイルを含むプロジェクトフォルダ全体を開くようにしましょう。
7-5. プロジェクト作成後にビルドエラーが出る
プロジェクト作成後にビルドエラーが出る場合は、エラーメッセージをよく読むことが重要です。
よくある原因は、コードの文法ミス、セミコロンの付け忘れ、全角記号の混入、クラス名やファイル名の不一致、必要なパッケージの不足などです。
まずは次のコマンドでビルドだけを実行します。
Bashdotnet build
エラーが出た行番号を確認し、該当するコードを見直します。
初心者に多いのは、半角のダブルクォーテーション"ではなく、全角の引用符を使ってしまうミスです。C#の記号は基本的に半角で入力しましょう。
7-6. 日本語パスや権限が原因で実行できない
C#環境構築では、プロジェクトの保存場所が原因でエラーになることもあります。
たとえば、フォルダ名に日本語、空白、特殊記号が含まれている場合、一部のツールや拡張機能で問題が起きることがあります。
初心者は、次のようなシンプルなパスを使うのがおすすめです。
C:\Projects\HelloCSharp
Macの場合は、次のような場所がわかりやすいです。
~/Projects/HelloCSharp
また、管理者権限が必要な場所にプロジェクトを作ると、ファイル作成やビルドに失敗することがあります。Program Files配下やシステムフォルダではなく、自分のユーザーフォルダ内に作成しましょう。
8. C#環境構築ができたら最初に覚えるべき基本操作
C#環境構築が完了したら、次に覚えるべきなのは開発の基本操作です。
C#では、コードを書くだけでなく、プロジェクトを作る、ビルドする、実行する、デバッグする、パッケージを追加する、Gitで管理する、という流れを理解する必要があります。
8-1. プロジェクトの作成方法
C#では、基本的にプロジェクト単位でアプリを作成します。
VS Codeやターミナルでは、次のコマンドでコンソールアプリを作れます。
Bashdotnet new console -n MyApp
このコマンドを実行すると、MyAppというフォルダとプロジェクトが作成されます。
フォルダに移動します。
Bashcd MyApp
実行します。
Bashdotnet run
Visual Studioの場合は、「新しいプロジェクトの作成」からテンプレートを選び、プロジェクト名と保存場所を指定して作成します。
8-2. ビルドと実行の違い
C#初心者が混乱しやすいのが、ビルドと実行の違いです。
ビルドとは、C#のコードをコンピュータが実行できる形に変換し、エラーがないか確認する作業です。
Bashdotnet build
実行とは、ビルドされたアプリを実際に動かすことです。
Bashdotnet run
dotnet runは内部的に必要に応じてビルドも行います。そのため、学習中はdotnet runを使うだけでも動作確認できます。
ただし、エラー確認だけをしたい場合はdotnet buildを使うと便利です。
8-3. デバッグの使い方
デバッグとは、プログラムを途中で止めながら動きを確認する作業です。
C#では、Visual StudioやVS Codeを使ってデバッグできます。
まず、確認したい行にブレークポイントを置きます。次に、デバッグ実行を開始します。プログラムがブレークポイントで止まったら、変数の値や処理の流れを確認します。
初心者が最初に覚えるべきデバッグ操作は、次の3つです。
ブレークポイントを設定する、ステップ実行で1行ずつ進める、変数の中身を確認する、の3つです。
デバッグを使えるようになると、エラーの原因を自分で見つけやすくなります。
8-4. NuGetパッケージの追加方法
NuGetは、.NETで使うライブラリを管理する仕組みです。.NET公式サイトでも、NuGetは.NETのパッケージマネージャーとして説明されています。
たとえば、JSON操作、データベース接続、ログ出力、テストなどの機能を追加するときにNuGetパッケージを使います。
ターミナルでパッケージを追加する例は次のとおりです。
Bashdotnet add package Newtonsoft.Json
追加済みのパッケージは、.csprojファイルに記録されます。
Visual Studioでは、プロジェクトを右クリックして「NuGetパッケージの管理」から追加できます。
8-5. Gitでソースコードを管理する方法
C#を学び始めたら、早い段階でGitも使い始めるとよいです。
Gitを使うと、コードの変更履歴を保存できます。間違ってコードを壊してしまったときも、以前の状態に戻しやすくなります。
プロジェクトフォルダで次のコマンドを実行します。
Bashgit init
変更を追加します。
Bashgit add .
コミットします。
Bashgit commit -m "Initial commit"
Visual StudioやVS CodeにはGit連携機能があるため、コマンドが苦手な場合でも画面操作で管理できます。
9. C#初心者が環境構築で迷わないためのチェックリスト
C#環境構築が完了したか不安な場合は、次のチェックリストを確認しましょう。
1つずつ確認すれば、どこで問題が起きているか切り分けやすくなります。
9-1. .NET SDKがインストールされているか
まず、.NET SDKが入っているか確認します。
Bashdotnet --version
バージョン番号が表示されればOKです。
さらに詳しく確認する場合は、次のコマンドを使います。
Bashdotnet --info
SDK一覧を確認する場合は、次のコマンドです。
Bashdotnet --list-sdks
RuntimeだけでなくSDKが入っていることを確認しましょう。
9-2. 開発エディタが準備できているか
次に、コードを書くためのエディタを確認します。
WindowsでVisual Studioを使う場合は、Visual Studioが起動できるか確認します。
VS Codeを使う場合は、VS Codeでプロジェクトフォルダを開けるか確認します。
初心者は、C#ファイルだけを単独で開くのではなく、.csprojファイルを含むフォルダ全体を開くようにしましょう。
9-3. C#拡張機能やワークロードが入っているか
Visual Studioの場合は、必要なワークロードが入っているか確認します。コンソールアプリやWindowsアプリを作るなら、「.NETデスクトップ開発」が入っていると安心です。
VS Codeの場合は、C#関連の拡張機能が入っているか確認します。補完やデバッグが使えない場合は、拡張機能のインストール状態を見直しましょう。
9-4. Hello Worldが実行できるか
C#環境構築の最終確認として、Hello Worldを実行します。
ターミナルで確認する場合は、次の流れです。
Bashmkdir HelloCSharp
cd HelloCSharp
dotnet new console
dotnet run
次のように表示されれば成功です。
Hello, World!
Hello Worldが動けば、C#の基本的な開発環境は整っています。
9-5. デバッグ実行ができるか
最後に、デバッグ実行ができるか確認します。
Visual Studioなら、行番号の左側をクリックしてブレークポイントを置き、デバッグ開始ボタンを押します。
VS Codeでも、C#拡張機能を設定したうえでブレークポイントを置き、実行とデバッグから開始します。
デバッグでプログラムが止まり、変数の中身を確認できれば、学習を進める準備は十分です。
10. C#環境構築に関するよくある質問
ここでは、C#環境構築で初心者が疑問に感じやすいポイントをQ&A形式で解説します。
10-1. C#の開発環境は無料で作れる？
はい、C#の開発環境は無料で作れます。
.NETは無料のオープンソース開発プラットフォームとして提供されており、Visual Studio CodeやVisual Studio Communityなどの無料ツールも利用できます。Microsoftの公式ページでも、.NETや関連する開発ツールは無料で利用できると案内されています。
学習目的であれば、Visual Studio Community、VS Code、.NET SDKの組み合わせで十分です。
10-2. C#はVS Codeだけで開発できる？
はい、C#はVS Codeだけでも開発できます。
ただし、VS Code本体だけでは不十分です。.NET SDKとC#拡張機能を追加する必要があります。
VS CodeでC#を開発する基本構成は、VS Code、.NET SDK、C#拡張機能の3つです。
コンソールアプリ、Web API、ASP.NET CoreアプリなどはVS Codeでも開発しやすいです。一方、Windowsデスクトップアプリを視覚的に作りたい場合は、Visual Studioのほうが便利です。
10-3. Visual StudioとVisual Studio Codeは何が違う？
Visual Studioは本格的な統合開発環境です。C#開発に必要な機能が多く含まれており、プロジェクト作成、ビルド、デバッグ、GUIデザイナー、テスト、Git連携などをまとめて使えます。
Visual Studio Codeは軽量なコードエディタです。必要な機能を拡張機能として追加して使います。起動が速く、Windows、Mac、Linuxで使いやすいのが特徴です。
初心者がWindowsでC#を学ぶならVisual Studioがわかりやすいです。MacやLinuxで学ぶ場合、または軽い環境で開発したい場合はVS Codeが向いています。
10-4. .NET Frameworkと.NETはどちらを使うべき？
これからC#を学ぶなら、基本的には.NETを使うのがおすすめです。
.NET Frameworkは、主にWindows向けの古い開発基盤です。既存の業務システムや古いWindowsアプリでは使われていますが、新しく学習を始める場合は、クロスプラットフォーム対応の現在の.NETを選ぶほうがよいでしょう。
特別な理由がなければ、.NET SDKの最新版または安定版をインストールし、.NET向けのプロジェクトを作成しましょう。
10-5. 初心者はどのC#環境から始めるのが最短？
Windowsユーザーなら、Visual Studio Communityをインストールし、「.NETデスクトップ開発」ワークロードを追加して始めるのが最短です。
Macユーザーなら、VS Code、.NET SDK、C#拡張機能の組み合わせが始めやすいです。
C#の文法を学ぶだけなら、最初はコンソールアプリで十分です。いきなりWebアプリやゲーム開発から始めると、C#以外の知識も必要になり、環境構築でつまずきやすくなります。
まずはHello Worldを動かし、変数、条件分岐、繰り返し、メソッド、クラスを学ぶ流れがおすすめです。
10-6. C#環境構築に失敗したときは何を確認すべき？
C#環境構築に失敗したときは、次の順番で確認しましょう。
まず、.NET SDKが入っているか確認します。
Bashdotnet --version
次に、SDK一覧を確認します。
Bashdotnet --list-sdks
Visual Studioを使っている場合は、必要なワークロードが入っているか確認します。
VS Codeを使っている場合は、C#拡張機能が入っているか、プロジェクトフォルダ全体を開いているか確認します。
さらに、プロジェクトの保存場所に日本語や特殊文字が含まれていないか、権限のないフォルダに作成していないかも確認しましょう。
エラーが出た場合は、エラーメッセージをそのまま検索するのも有効です。C#環境構築のエラーは、多くの場合、SDK、PATH、ワークロード、拡張機能、保存場所のいずれかに原因があります。
まとめ
C#環境構築では、まず「エディタまたはIDE」「.NET SDK」「実行確認」の3つをそろえることが大切です。
Windowsで初心者が最短で始めるなら、Visual Studio Communityをインストールし、「.NETデスクトップ開発」ワークロードを選ぶ方法がわかりやすいです。画面操作でプロジェクト作成、実行、デバッグまでできるため、最初の学習に向いています。
VS CodeでC#環境を作る場合は、VS Code本体に加えて、.NET SDKとC#拡張機能をインストールします。ターミナルでdotnet new console、dotnet runを実行できれば、C#開発を始められます。
MacでC#を始める場合は、Visual Studio for Macではなく、VS Codeと.NET SDKを中心に環境を作るのが現在の基本です。
C#環境構築ができたら、まずはHello Worldを実行し、次にビルド、実行、デバッグ、NuGet、Gitの基本操作を覚えましょう。最初から完璧な環境を目指す必要はありません。小さなコンソールアプリを作りながら、少しずつC#の開発環境に慣れていくことが、初心者にとって最短の学習ルートです。