第1章：ASP.NET Core 開発環境セットアップ

対象バージョン: .NET 10 (LTS) / .NET 9 (STS)
参考: Microsoft 公式ドキュメント

1. .NET SDK / ランタイムとは

.NET には大きく SDK と ランタイム の 2 種類のコンポーネントがあります。

graph TD
    SDK["📦 .NET SDK\n（開発・ビルド用）"]
    RT_ASP["🌐 ASP.NET Core Runtime\n（Web アプリ実行用）"]
    RT_NET["⚙️ .NET Runtime\n（通常アプリ実行用）"]
    RT_DESK["🖥️ .NET Desktop Runtime\n（WPF / WinForms 実行用）\nWindows のみ"]

    SDK -->|含む| RT_ASP
    SDK -->|含む| RT_NET
    SDK -->|含む| RT_DESK

コンポーネント	用途	含まれるもの
.NET SDK	アプリの開発・ビルド・発行	.NET Runtime + ASP.NET Core Runtime + CLI ツール
ASP.NET Core Runtime	Web アプリの実行	.NET Runtime を含む
.NET Runtime	通常の .NET アプリ実行	最小構成
.NET Desktop Runtime	WPF / WinForms の実行（Windows のみ）	.NET Runtime を含む

2. LTS / STS のサポート期間

.NET のリリースには LTS (Long Term Support) と STS (Standard Term Support) の 2 種類があり、奇数バージョンが STS、偶数バージョンが LTS となっています。

gantt
    title .NET バージョン サポートスケジュール
    dateFormat YYYY-MM
    axisFormat %Y年%m月
    todayMarker off

    section LTS（長期サポート）
    .NET 8 LTS    :2023-11, 2026-11
    .NET 10 LTS   :2025-11, 2028-11

    section STS（標準サポート）
    .NET 9 STS    :2024-11, 2026-11
    .NET 11 STS   :2026-11, 2028-11

バージョン	種類	リリース	サポート終了	状態
.NET 10	LTS	2025年11月	2028年11月	✅ サポート中
.NET 9	STS	2024年11月	2026年11月	✅ サポート中
.NET 8	LTS	2023年11月	2026年11月	✅ サポート中
.NET 7	STS	2022年11月	2024年5月	❌ サポート終了

どのバージョンを選ぶべきか？

flowchart TD
    Start([バージョン選択]) --> Q1{継続的にアップデートできる？}
    Q1 -->|Yes| Latest["最新版（.NET 10）を使用\n最新機能が利用可能"]
    Q1 -->|No| Q2{長期間サポートが必要？}
    Q2 -->|Yes| LTS["LTS 版（.NET 10 / .NET 8）を使用\n3年間サポート保証"]
    Q2 -->|No| STS["STS 版（.NET 9）でも OK\n2年間サポート"]

    style Latest fill:#4CAF50,color:#fff
    style LTS fill:#2196F3,color:#fff
    style STS fill:#FF9800,color:#fff

3. OS 別セットアップ

3.1 Windows

flowchart LR
    W1["① dotnet.microsoft.com\nにアクセス"] --> W2["② .NET SDK を\nダウンロード"]
    W2 --> W3["③ インストーラーを\n実行（管理者権限）"]
    W3 --> W4["④ dotnet --version\nで確認"]

    style W4 fill:#4CAF50,color:#fff

方法 A: インストーラー（推奨）

https://dotnet.microsoft.com/download にアクセス
.NET 10.0 (LTS) の SDK をダウンロード（Intel CPU → x64、ARM CPU → Arm64）
ダウンロードした .exe を管理者として実行
インストール完了後、確認:

dotnet --version
# 例: 10.0.201

方法 B: WinGet（コマンドラインで一発）

# SDK をインストール（開発者向け・推奨）
winget install Microsoft.DotNet.SDK.10

# または ASP.NET Core Runtime のみ（実行環境用）
winget install Microsoft.DotNet.AspNetCore.10

# インストール済み SDK 一覧を確認
dotnet --list-sdks

方法 C: PowerShell スクリプト（CI / 非管理者環境向け）

# スクリプトをダウンロード
Invoke-WebRequest https://dot.net/v1/dotnet-install.ps1 -OutFile dotnet-install.ps1

# 最新 LTS 版 SDK をインストール
.\dotnet-install.ps1

# バージョンを指定する場合
.\dotnet-install.ps1 -Channel 10.0

インストール先

アーキテクチャ	SDK のインストール先
x64 / Arm64	`C:\Program Files\dotnet\`
x64 (ARM PC 上での x64 SDK)	`C:\Program Files\dotnet\x64\`

3.2 macOS

flowchart LR
    M1["① dotnet.microsoft.com\nにアクセス"] --> M2["② macOS 向け SDK\nをダウンロード"]
    M2 --> M3["Apple Silicon → Arm64\nIntel → x64"]
    M3 --> M4["③ .pkg を実行\nインストール完了"]
    M4 --> M5["④ dotnet --version\nで確認"]

    style M5 fill:#4CAF50,color:#fff

方法 A: インストーラーパッケージ（推奨）

https://dotnet.microsoft.com/download/dotnet にアクセス
.NET 10.0 を選択し、macOS 向け SDK をダウンロード
- Apple Silicon（M1/M2/M3/M4 等） → Arm64
- Intel Mac → x64
ダウンロードした .pkg をダブルクリックしてインストール
確認:

dotnet --version
# 例: 10.0.201

方法 B: インストールスクリプト

# wget がない場合は Homebrew でインストール
brew install wget

# インストールスクリプトをダウンロード
wget https://dot.net/v1/dotnet-install.sh

# 実行権限を付与
chmod +x dotnet-install.sh

# 最新 LTS 版をインストール
./dotnet-install.sh

PATH の設定（スクリプトでインストールした場合）

インストールスクリプトを使用した場合、~/.dotnet にインストールされます。ターミナルから使えるよう、シェルの設定ファイルに PATH を追加してください。

# ~/.zshrc（Zsh の場合）または ~/.bash_profile（Bash の場合）に追記
export DOTNET_ROOT=$HOME/.dotnet
export PATH=$PATH:$DOTNET_ROOT:$DOTNET_ROOT/tools

設定を反映:

source ~/.zshrc   # Zsh の場合
# または
source ~/.bash_profile

Apple Silicon（M シリーズ）の注意点

バージョン	インストール先
Arm64 版 SDK	`/usr/local/share/dotnet/`
x64 版 SDK（Rosetta 2 経由）	`/usr/local/share/dotnet/x64/dotnet/`

3.3 Linux (Ubuntu)

Ubuntu の場合、パッケージマネージャーから直接インストールできます。

flowchart LR
    L1["Ubuntu 24.04\n（Ubuntu パッケージに含まれる）"] --> L2["apt-get update"]
    L2 --> L3["apt-get install\ndotnet-sdk-10.0"]
    L3 --> L4["dotnet --version\nで確認"]

    style L4 fill:#4CAF50,color:#fff

Ubuntu 24.04 / 25.04 / 25.10

# パッケージリストを更新して SDK をインストール
sudo apt-get update && \
  sudo apt-get install -y dotnet-sdk-10.0

SDK ではなくランタイムのみが必要な場合（本番環境等）:

# ASP.NET Core Runtime（Web アプリ実行用・推奨）
sudo apt-get install -y aspnetcore-runtime-10.0

# .NET Runtime のみ（最小構成）
sudo apt-get install -y dotnet-runtime-10.0

Red Hat / Fedora / CentOS Stream

# Fedora の場合
sudo dnf install dotnet-sdk-10.0

# RHEL の場合（subscription-manager でリポジトリを有効化後）
sudo dnf install dotnet-sdk-10.0

スクリプトによるインストール（ディストリビューション共通）

# インストールスクリプトをダウンロード
curl -O https://dot.net/v1/dotnet-install.sh
chmod +x dotnet-install.sh

# 最新 LTS をインストール
./dotnet-install.sh --channel LTS

# バージョン指定
./dotnet-install.sh --channel 10.0

インストール確認（全 OS 共通）

# SDK バージョン確認
dotnet --version

# インストール済み SDK 一覧
dotnet --list-sdks

# インストール済みランタイム一覧
dotnet --list-runtimes

# 詳細情報
dotnet --info

出力例:

10.0.201

.NET SDKs installed:
  8.0.415 [/usr/local/share/dotnet/sdk]
  10.0.201 [/usr/local/share/dotnet/sdk]

.NET runtimes installed:
  Microsoft.AspNetCore.App 8.0.15 [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.App]
  Microsoft.AspNetCore.App 10.0.3 [/usr/local/share/dotnet/shared/Microsoft.AspNetCore.App]

4. IDE 準備

ASP.NET Core 開発に対応した主要な IDE を 3 つ紹介します。

graph TD
    subgraph IDE["IDE 選択ガイド"]
        VS["🪟 Visual Studio 2022+\n最強の Windows 専用 IDE\n・デバッガー最強\n・SQL Server 連携\n・Designer / Profiler 付属\n無料（Community）～有料"]
        VSC["💻 Visual Studio Code\n軽量クロスプラットフォーム\n・Windows / macOS / Linux 対応\n・C# Dev Kit 拡張が必要\nVS Code 本体は無料\nC# Dev Kit は商用利用に要サブスク"]
        Rider["🚀 JetBrains Rider\nクロスプラットフォーム高機能 IDE\n・Windows / macOS / Linux 対応\n・リファクタリング最強\n有料（30日試用可）"]
    end

    Windows["Windows"] -->|最推奨| VS
    Windows -->|軽量開発| VSC
    Mac["macOS / Linux"] -->|無料| VSC
    Mac -->|高機能| Rider

4.1 Visual Studio（Windows のみ）

Visual Studio は .NET / ASP.NET Core 開発に最も最適化された Windows 専用 IDE です。

必要バージョン

.NET バージョン	最小 Visual Studio バージョン
.NET 10	Visual Studio 2026 (v18.0+)
.NET 9	Visual Studio 2022 (v17.12+)
.NET 8	Visual Studio 2022 (v17.8+)

インストール手順

Visual Studio ダウンロードページから Visual Studio Installer をダウンロード
インストーラーを起動し、ワークロードを選択:

graph LR
    subgraph Required["必須ワークロード"]
        W1["🌐 ASP.NET と Web 開発\n（ASP.NET Core 開発に必須）"]
    end

インストール完了後、Visual Studio を起動
新しいプロジェクトの作成から ASP.NET Core テンプレートを選択

4.2 Visual Studio Code + C# Dev Kit

VS Code は軽量でクロスプラットフォームなエディターです。C# Dev Kit 拡張を追加することで、Visual Studio に近いエクスペリエンスが得られます。

C# Dev Kit のライセンス（重要）

⚠️ C# Dev Kit は完全に無料ではありません。
Visual Studio と同じライセンスモデルが適用されます。

利用シナリオ	利用可否
個人開発・学習・実験	✅ 無料
学術・教育機関	✅ 無料
オープンソース開発	✅ 無料
組織での商用開発	⚠️ Visual Studio Professional / Enterprise サブスクリプションが必要
GitHub Codespaces	✅ プランに含まれる

組織での利用には、Visual Studio Professional または Enterprise のサブスクリプションが必要です。個人学習や OSS 開発であれば無償で利用できます。詳細はライセンス条件（MS 公式）を参照してください。

セットアップ手順

flowchart LR
    S1["① VS Code をインストール\ncode.visualstudio.com"] --> S2["② C# Dev Kit 拡張を\nインストール"]
    S2 --> S3["③ .NET SDK が\n未インストールなら自動提案"]
    S3 --> S4["④ プロジェクトを開いて\n開発スタート"]

    style S4 fill:#4CAF50,color:#fff

Visual Studio Code をダウンロードしてインストール
VS Code を起動し、拡張機能マーケットプレイスから C# Dev Kit (ms-dotnettools.csdevkit) をインストール:
```
Ctrl+Shift+X（Windows/Linux）または Cmd+Shift+X（macOS）
→ 検索: "C# Dev Kit"
→ インストール
```
C# Dev Kit には以下の拡張が含まれます:

拡張役割
C# Dev Kit プロジェクト管理、テスト Explorer、ソリューション Explorer
C# IntelliSense、コード補完、デバッガー
IntelliCode for C# Dev Kit AI 補完

拡張	役割
C# Dev Kit	プロジェクト管理、テスト Explorer、ソリューション Explorer
C#	IntelliSense、コード補完、デバッガー
IntelliCode for C# Dev Kit	AI 補完

4.3 JetBrains Rider

JetBrains Rider はクロスプラットフォームで動作するフル機能の .NET IDE です。特にリファクタリングや静的解析が強力です。

対応 OS: Windows / macOS / Linux
ライセンス: 有料（30 日間無料トライアルあり）
ダウンロード: https://www.jetbrains.com/rider/

5. .NET CLI 基本コマンド

.NET CLI（コマンドラインインターフェイス）は、.NET SDK に含まれるクロスプラットフォームツールです。IDEがなくてもアプリの作成・ビルド・実行が可能です。

graph LR
    subgraph CLI["dotnet コマンド体系"]
        direction TB
        Create["📁 作成\ndotnet new"]
        Build["🔨 ビルド\ndotnet build"]
        Run["▶️ 実行\ndotnet run"]
        Test["🧪 テスト\ndotnet test"]
        Publish["🚀 発行\ndotnet publish"]
        Watch["👁️ ウォッチ\ndotnet watch"]
        Package["📦 パッケージ\ndotnet add package"]
    end

基本コマンド一覧

コマンド	説明	例
`dotnet new <テンプレート>`	プロジェクトを作成	`dotnet new webapi -o MyApi`
`dotnet build`	プロジェクトをビルド	`dotnet build`
`dotnet run`	アプリを実行	`dotnet run`
`dotnet test`	テストを実行	`dotnet test`
`dotnet publish`	発行用ファイルを生成	`dotnet publish -c Release`
`dotnet watch`	ファイル変更を監視して自動再起動	`dotnet watch run`
`dotnet clean`	ビルド出力を削除	`dotnet clean`
`dotnet restore`	NuGet パッケージを復元	`dotnet restore`
`dotnet --info`	SDK / Runtime の情報を表示	`dotnet --info`
`dotnet new list`	テンプレート一覧を表示	`dotnet new list`

パッケージ管理コマンド

# NuGet パッケージを追加
dotnet add package Microsoft.EntityFrameworkCore

# インストール済みパッケージ一覧
dotnet list package

# パッケージを削除
dotnet remove package Microsoft.EntityFrameworkCore

# パッケージを更新
dotnet add package Microsoft.EntityFrameworkCore --version 9.0.0

ビルドと実行の流れ

sequenceDiagram
    participant Dev as 開発者
    participant CLI as dotnet CLI
    participant Compiler as C# コンパイラ
    participant App as アプリ

    Dev->>CLI: dotnet new webapi
    CLI-->>Dev: プロジェクト作成完了

    Dev->>CLI: dotnet build
    CLI->>Compiler: ソースファイルをコンパイル
    Compiler-->>CLI: bin/ に出力
    CLI-->>Dev: ビルド成功

    Dev->>CLI: dotnet run
    CLI->>App: アプリを起動
    App-->>Dev: http://localhost:5xxx で待ち受け

    Dev->>CLI: dotnet watch run
    CLI->>App: 起動 + ファイル変更を監視
    Note over CLI,App: コード変更時に自動再起動（Hot Reload）

6. 初回プロジェクト作成

ASP.NET Core の主要なプロジェクトテンプレートを紹介します。

テンプレート比較一覧

graph TD
    ASP["ASP.NET Core\nプロジェクト"] --> Web_API["Web API"]
    ASP --> MVC["MVC Web App"]
    ASP --> Empty["Empty"]

    Web_API --> MinimalAPI["minimal API\n(webapi)\nシンプル・高速\n✅ .NET 8+ 推奨"]
    Web_API --> ControllerAPI["Controller API\n(webapi --use-controllers)\nREST API 向け\n大規模プロジェクト向け"]
    Web_API --> AOT["AOT API\n(webapiaot)\nNative AOT\n最高パフォーマンス"]

    MVC --> MVCApp["ASP.NET Core MVC\n(mvc)\nUI + コントローラー"]
    MVC --> RazorPages["Razor Pages\n(webapp)\nページベース"]

テンプレート	コマンド	用途
ASP.NET Core Web API (Minimal API)	`dotnet new webapi`	REST API・マイクロサービス
ASP.NET Core Web API (コントローラー)	`dotnet new webapi --use-controllers`	大規模 REST API
ASP.NET Core API (Native AOT)	`dotnet new webapiaot`	高パフォーマンス API
ASP.NET Core MVC	`dotnet new mvc`	サーバーサイドレンダリング Web アプリ
ASP.NET Core Web App (Razor Pages)	`dotnet new webapp`	ページ中心のシンプルな Web アプリ
ASP.NET Core gRPC	`dotnet new grpc`	gRPC サービス
Worker Service	`dotnet new worker`	バックグラウンドサービス
ASP.NET Core Empty	`dotnet new web`	最小構成（カスタム用途）

6.1 Web API プロジェクト（最もよく使う）

# プロジェクトを作成
dotnet new webapi -n MyWebApi -o MyWebApi

# 作成されたディレクトリに移動
cd MyWebApi

# 実行
dotnet run