C#の開発環境構築 — .NET SDKのインストールからdotnet runまで

C#を書き始めるのに必要なものは、実質ひとつだけです。.NET SDK を入れれば、コンパイラもビルドツールも実行環境もまとめて手に入ります。

この章では、SDKのインストールから最初のプロジェクトを動かすところまでを行い、あわせて生成されるファイルの意味を確認します。

学習者

Node.jsのときは「Node本体を入れればnpmも付いてくる」感じでしたが、C#も同じですか？

先生

かなり近いよ。.NET SDKを入れると dotnet コマンドが使えるようになって、作成・ビルド・実行・テスト・パッケージ追加まで全部これ1つでできる。

SDKとランタイムはどちらを入れるのか

ダウンロードページには「SDK」と「ランタイム」の2種類が並んでいます。開発するなら迷わずSDKです。

インストールする

OSごとに手順が違いますが、いずれも.NETのダウンロードページからLTS版を選ぶのが基本です。パッケージマネージャーを使うなら次のようになります。

# Windows
winget install Microsoft.DotNet.SDK.8
 
# macOS
brew install --cask dotnet-sdk
 
# Ubuntu / Debian
sudo apt-get install -y dotnet-sdk-8.0

インストールできたら、必ずバージョンを確認します。

dotnet --version
# 8.0.404
 
dotnet --list-sdks
# 8.0.404 [/usr/local/share/dotnet/sdk]

エディタを選ぶ

VS Codeを使う場合は、拡張機能の C# Dev Kit を入れると、補完・デバッグ・テスト実行が揃います。これを入れないとIntelliSenseがほとんど効かないため、最初に入れておいてください。

最初のプロジェクトを作る

C#では、単体の .cs ファイルを直接実行するのではなく、プロジェクト単位で扱うのが基本です。

dotnet new console -o HelloApp
cd HelloApp

構文： dotnet new <テンプレート名> [-o 出力先] [-f フレームワーク]

戻り値： なし（指定ディレクトリにプロジェクト一式が生成される）

利用できるテンプレートの一覧は dotnet new list で確認できます。

生成されるファイル

HelloApp/
├── HelloApp.csproj   ← プロジェクト設定
├── Program.cs        ← エントリポイント
└── obj/              ← ビルドの中間生成物

Program.cs の中身は1行だけです。

Console.WriteLine("Hello, World!");

HelloApp.csproj はプロジェクトの設定ファイルで、npmの package.json にあたります。

<Project Sdk="Microsoft.NET.Sdk">
 
  <PropertyGroup>
    <OutputType>Exe</OutputType>
    <TargetFramework>net8.0</TargetFramework>
    <ImplicitUsings>enable</ImplicitUsings>
    <Nullable>enable</Nullable>
  </PropertyGroup>
 
</Project>

Nullable については C#のnull安全 で詳しく扱います。

実行する

dotnet run
# Hello, World!

dotnet コマンドのうち、開発中によく使うものを整理します。

書きながら試すときは dotnet watch が便利です。ファイルを保存するたびに再ビルドと再実行が走ります。

dotnet watch run

複数プロジェクトをまとめるソリューション

実務では、Web APIとテストプロジェクトのように複数のプロジェクトを1つのアプリとして扱います。それをまとめる単位がソリューションです。

dotnet new sln -n MyApp
dotnet sln add HelloApp/HelloApp.csproj

学習中は1プロジェクトで十分ですが、エディタで「プロジェクトが認識されない」と言われたときは、ソリューションに追加できているかを確認してください。

よくあるハマりどころ

手元のSDKとcsprojのバージョンが合っていない

TargetFramework に net8.0 と書かれているのに、手元のSDKが net6.0 しか入っていないとビルドできません。dotnet --list-sdks で入っているバージョンを確認します。

チームで揃えたい場合は、リポジトリのルートに global.json を置いてSDKバージョンを固定できます。

{
  "sdk": {
    "version": "8.0.404",
    "rollForward": "latestFeature"
  }
}

プロジェクトの外で dotnet run している

dotnet run は、カレントディレクトリのプロジェクトを探して実行します。.csproj があるディレクトリに移動してから実行してください。

学習者

「プロジェクトファイルが見つかりません」というエラーが出たときは、だいたいこれですか？

そのケースがほとんどです。ソリューション直下で実行した場合は、dotnet run --project HelloApp のようにプロジェクトを明示すると動きます。

obj や bin をコミットしてしまう

obj/ と bin/ はビルドの生成物なので、.gitignore に入れます。dotnet new gitignore を実行すると、.NET向けの .gitignore が生成されます。

ちゃんと使うためのポイント

• 開発マシンに入れるのはSDK。ランタイムはSDKに含まれる
• プロジェクトは dotnet new console -o 名前 で作る
• dotnet run はビルドと実行をまとめて行う。試行錯誤には dotnet watch
• .csproj はプロジェクト設定ファイル。TargetFramework と Nullable は最初に目を通す
• VS Codeで書くなら C# Dev Kit を入れる
• チームで揃えるときは global.json でSDKバージョンを固定する

環境が整ったら、次の章では変数と型を扱います。C#の学習で最初に効いてくる「値型と参照型の違い」を、ここで押さえます。

参考リンク

• Microsoft Learn — dotnet new コマンド
• Microsoft Learn — dotnet run コマンド
• .NET のダウンロード