Windows上で「.NET 10 Preview/RC」を試したい開発者向けに、Visual Studio 2022(17.14.4 安定版)での可否、必要なIDEの選択、CLI運用の現実解、そして安全に導入・共存させるための具体手順と落とし穴を、最新のバージョン要件に基づいて整理しました。結論だけ急ぐ方は「要点まとめ」と「手順」に目を通せば、そのまま作業に移れます。
.NET 10 Preview を Windows で試すための結論(要点)
- Visual Studio 2022 v17.14.4(安定/Current チャネル)単体では
net10.0をターゲットにした IDEビルドやテンプレート生成は不可です。プロジェクトで<TargetFramework>net10.0</TargetFramework>を指定すると、IDE ではNETSDK1209(「この Visual Studio では .NET 10 をターゲットできない」趣旨)などのエラーが出ます。 - IDE での正式サポートは Visual Studio 2026(v18 系)Insiders/Preview で提供されています。
VS 2022 の「Preview チャネル」に切り替えても v17 系の範囲であり、.NET 10 の IDE サポートは解放されません。 - それでも Windows 上で.NET 10 を試したい場合は、次の二択です。
- Visual Studio 2026 Insiders(v18)を安定版 VS 2022 と並行インストールして、テンプレート作成・ビルド・F5デバッグまで IDE で完結。
- .NET 10 Preview SDK を単体インストールし、
dotnetCLI でビルド/テストしつつ VS Code や Rider で編集(IDE のビルド統合は使わない運用)。
背景とバージョン要件の整理
.NET は毎年秋にメジャー更新されるサイクルで、.NET 10 は 2025 年 11 月の LTS(3 年サポート)リリースに向け、2025 年夏〜秋にかけて Preview/RC が段階的に公開されました。これに合わせて .NET SDK 側は「対応する Visual Studio/ MSBuild の最小バージョン」を厳格に設けるため、古い IDE で新しい TFM(net10.0)を使うと IDE がブロックされます。結果として、VS 2022(17.x)では .NET 10 をターゲットとする IDE ビルドはサポート外です(CLI は可)。
バージョン相性早見表
| 組み合わせ | プロジェクト作成(テンプレート) | ビルド(IDE) | デバッグ(F5) | CLI(dotnet build) | 備考 |
|---|---|---|---|---|---|
| VS 2022 v17.14.4 + .NET 10 SDK | 不可 | 不可(NETSDK1209) | 不可 | 可 | IDE は非対応。CLI で生成/ビルドは可能。 |
| VS 2022 v17.14.* Preview + .NET 10 SDK | 不可 | 不可 | 不可 | 可 | v17 系 Preview でも方針は同じ。IDE はブロック。 |
| VS 2026(v18)Insiders/Preview + .NET 10 SDK | 可 | 可 | 可 | 可 | .NET 10 を IDE で使うならこれが正攻法。 |
| VS Code/Rider + .NET 10 SDK | 可(CLI使用) | — | 可 | 可 | 編集・デバッグは可。テンプレート生成/ビルドは CLI に依存。 |
質問への直接回答
「VS 2022 v17.14.4(安定版)のまま .NET 10 Preview SDK を使えるか?」
IDE としては不可です。プロジェクトの TargetFramework を net10.0 にすると、IDE では「このバージョンの Visual Studio は .NET 10 をサポートしません(NETSDK1209)」といったエラーになります。ただし、SDK を入れて CLI(dotnet)でのビルドやテストは可能です。
「SDK は Visual Studio に同梱? それとも Preview 版の Visual Studio が必要?」
- Visual Studio 2026(v18)Insiders/Preview は .NET 10 を IDE レベルでサポートします。VS 2026 を入れれば、テンプレート・ビルド・F5 まで IDE で完結できます。
- Visual Studio 2022(v17.x) は .NET 10 の IDE サポート対象外です。SDK は OS に共通インストールされるため VS 2022 からも検出はしますが、.NET 10 をターゲットにした IDE ビルドはブロックされます。
「安定版で使えないなら、どう環境を切り替えればいい?」
次のどちらかを選びます。
- VS 2026 Insiders を安定版 VS 2022 と並行インストール(推奨)… 安定環境を壊さず IDE で .NET 10 を試せます。
- SDK 単体 + CLI + VS Code/Rider… IDE ビルドにこだわらず、
dotnet new/build/testで検証する運用です。
実践:インストールと切り替え・共存手順
パターンA:Visual Studio 2026 Insiders を追加して IDE で試す(推奨)
- 管理者権限のユーザーで Windows にサインイン。
- Visual Studio 2026 Insiders のブートストラッパーを取得して起動(VS 2022 は終了させておく)。
- ワークロード選択で、少なくとも次を選びます:
- .NET デスクトップ開発
- ASP.NET と Web 開発
- 必要に応じて:.NET MAUI(モバイル/デスクトップ)、Azure 開発、ユニバーサル Windows プラットフォーム(UWP は互換性に注意)など
- インストール後、VS 2026 を起動。
[ツール > オプション > 環境 > プレビュー機能]で「.NET SDK のプレビューを使用」をオンにする設定が残っている場合は有効化(必須ではありませんが、プレビュー SDK を積極的に拾いたいときに便利)。 - 新規作成で「コンソール アプリ」や「ASP.NET Core Web API」を選び、ターゲット フレームワークに
.NET 10 (Preview/RC)を指定して作成。 - ビルド/実行(F5)して動作を確認。
ポイント:VS 2026 は VS 2022 と別製品として共存できます。アンインストールも相互に独立です。既存ソリューションを VS 2022 で維持しつつ、検証用に VS 2026 を追加するのが安全です。
パターンB:SDK 単体 + CLI + VS Code で試す(軽量)
- .NET 10 Preview/RC SDK をインストール(Windows Installer もしくは WinGet)。
winget install --id=Microsoft.DotNet.SDK.Preview -eインストール後に次で確認します。dotnet --version dotnet --list-sdks | findstr "10.0" dotnet --info - 検証用の作業フォルダーを用意し、global.json で SDK を固定(複数 SDK 共存時の取り違え防止)。
{ "sdk": { "version": "10.0.100-rc.2.x", "rollForward": "feature" } }※versionにはdotnet --list-sdksで見える自端末の 10.0 系を入れてください。 - テンプレートの作成とビルド/テスト。
dotnet new console -n HelloNet10 -f net10.0 cd HelloNet10 dotnet build -c Debug dotnet run - VS Code でフォルダーを開き、C# Dev Kit / C# 拡張を有効化してデバッグ構成を作成(VS Code 側の依存は最小限)。
ポイント:CLI での生成・ビルド・テストは .NET 10 SDK さえ入っていれば可能です。IDE の「ターゲット選択 UI」や「Designer」が不要な検証なら、最短で着手できます。
「チャネル切り替え」の正しい理解
Visual Studio には「Current/Preview/LTSC などの アップデート チャネル」の概念があり、VS Installer の[…(もっと) > Update 設定 > チャネル]から切り替えられます。ただしこれは 「同じメジャー(v17 なら 17.x の範囲)」の更新経路を変える仕組みであり、v17 → v18(VS 2022 → VS 2026)の乗り換え手段ではありません。
したがって、VS 2022 を Preview チャネルにしても .NET 10 の IDE サポートは得られません。IDE で .NET 10 を使うには VS 2026(v18)系を別途導入してください。
よくあるエラーと対処
| エラー(例) | 原因 | 対処 |
|---|---|---|
NETSDK1209: The current Visual Studio version does not support targeting .NET 10.0 ... | VS 2022 など、IDE が .NET 10 の TFM をサポートしない。 | VS 2026 Insiders/Preview を使用(IDE でやる場合)。または CLI で dotnet build。 |
NETSDK1045: The current .NET SDK does not support targeting ... | インストールされた SDK が古く、要求する TFM に未対応。 | 要求バージョンの .NET 10 SDK をインストール。global.json で明示固定し混在を防ぐ。 |
NETSDK1013: The TargetFramework value was not recognized. | TargetFramework の誤記/対応 SDK 未導入。 | net10.0 の綴りを確認し、.NET 10 SDK を導入。dotnet --list-sdks で存在を検証。 |
テンプレートに .NET 10 が表示されない | IDE が v17 系などで非対応/プレビュー選択 UI の制限。 | VS 2026 を使用、もしくは CLI の -f net10.0 で生成。 |
安全に導入・運用するためのベストプラクティス
| 項目 | 推奨対応 |
|---|---|
| 既存プロジェクトへの影響 | 拡張機能やビルドタスクの未対応リスクあり。バックアップ必須・別マシン/VM/コンテナでの検証推奨。 |
| 共存インストール | VS 2022(安定)と VS 2026(Insiders)を別インスタンスで共存。Installer で個別に追加・更新する。 |
| SDK の固定 | global.json でプロジェクト単位の SDK バージョンを明示固定。CI とローカルの再現性を確保。 |
| マルチターゲット | net9.0;net10.0 のように並記し、IDE 非対応環境では net9.0 を中心にビルドする運用が安全。 |
| リリース時期 | .NET 10 は 2025 年 11 月に LTS として一般提供。正式化後も IDE 側のサポート境界は維持される想定。 |
| 混同しやすい表記 | 「Visual Studio 17.14 で含まれる」のような文言は v17 系の話。.NET 10 の IDE サポートは v18(VS 2026)系に整理された点に注意。 |
実用テクニック:.NET 10 Preview を素早く検証するミニ手順
コンソール アプリ(CLI)
mkdir C:\work\dotnet10-try
cd /d C:\work\dotnet10-try
dotnet new globaljson --sdk-version 10.0.100-rc.2.x --roll-forward feature
dotnet new console -n HelloRc2 -f net10.0
cd HelloRc2
dotnet build
dotnet run
ASP.NET Core API(CLI)
cd /d C:\work\dotnet10-try
dotnet new webapi -n TodoApi10 -f net10.0 --use-controllers
cd TodoApi10
dotnet build
dotnet test // 単体テスト追加後
dotnet run // ローカル実行
プロジェクトファイル例(機能フラグを使う場合)
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFramework>net10.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
<LangVersion>preview</LangVersion> <!-- C# 14 でプレビュー機能を使う場合 -->
</PropertyGroup>
</Project>
VS 2022 を使い続けたい場合の現実解(混在期の運用)
- 編集は VS 2022、ビルドは CLI… ソリューションは VS 2022 で開き、ビルド/テスト/発行はターミナルで
dotnetを使用。
デバッグが必要な場合は VS Code の launch.json を用意してアタッチ/起動。 - マルチターゲットで段階移行… ライブラリは
TargetFrameworks=net9.0;net10.0としておき、IDE ではnet9.0を中心にビルド。CI では両方をビルドして回帰を監視。 - ブランチ分離… 大型製品でリスクを最小化したい場合、
net10対応ブランチを切り、CI のエージェントに .NET 10 SDK をインストールして検証。
アンインストール/ロールバック/隔離のコツ
- SDK のクリーンアップ:
dotnet --list-sdksで複数の 10.0 系が見える場合、不要版は「アプリと機能」からアンインストール。誤消去を防ぐため、global.jsonで使用版を固定してから作業するのが安全です。 - Dev Container/WSL/VM:
プレビュー評価はコンテナや仮想マシンに閉じ込めると本番環境への影響を最小化できます。Windows なら Hyper‑V/WSL2 を活用。 - VS 2026 の削除:
VS Installer から VS 2026 インスタンスのみを選択してアンインストールすれば、VS 2022 には影響しません。
チェックリスト:導入前に確認したいこと
- 端末の Windows 更新(.NET SDK インストーラや MSBuild の前提更新が必要な場合あり)。
- 社内のコード解析/拡張機能(ReSharper、Roslyn Analyzers 等)のプレビュー対応状況。
- CI/CD(ビルドエージェント)への SDK 追加、キャッシュクリア手順。
- ライブラリ依存(NuGet)の
net10.0サポート状況。互換 TFM(netstandard2.0/2.1)で当座を凌げるか。
トラブルシューティング深掘り
Visual Studio が .NET 10 を「認識するがビルドできない」理由
.NET SDK は OS 共通にインストールされるため、VS 2022 でも「SDK がある」こと自体は検出します。しかし IDE—MSBuild 統合側にバージョン下限があり、未満の IDE では TFM net10.0 を「ターゲットとして選ばせない/ビルドさせない」動作になります。このため「項目は見えるのにビルドができない/テンプレートが出ない」といった齟齬に見えます。
グローバルとローカルの SDK 解決順序
複数 SDK があるとき、プロジェクト直下の global.json が最優先で、その後はインストール済み SDK の新しい順に解決されます。global.json で 10.0 系を固定し、rollForward を feature 以上にしておくと、マイナー更新を取り込みながら大きなズレを避けられます。
マルチターゲット時に IDE を壊さない工夫
IDE 非対応の net10.0 を含むとビルドが通らない場合、CI 側は dotnet build -f net10.0、ローカル IDE は net9.0 のみをビルドする分業が現実的です。どうしても IDE のビルドで失敗してしまう場合は、$(VisualStudioVersion) に基づく条件分岐で TargetFrameworks を切り替える高度な MSBuild 設定(上級者向け)もあります。
ケース別のおすすめ構成
| 用途 | おすすめ | 理由 |
|---|---|---|
| 新機能を広く試したい(IDE 派) | VS 2026 Insiders + .NET 10 SDK | テンプレート・デザイナ・F5 デバッグまで IDE で完結。 |
| 安全に触りたい(まずは最小投資) | SDK 単体 + CLI + VS Code | 既存環境に手を入れず評価可能。撤収も容易。 |
| チーム合意前の段階的導入 | マルチターゲット(net9.0;net10.0)+ CI 分業 | IDE は従来通り。CI で net10.0 を先行検証。 |
| 本番リリース準備(LTS 移行) | VS 2026 安定版登場後に統一 | IDE/SDK/CI を同一メジャーで固め、移行コストとリスクを最小化。 |
まとめ(運用判断の指針)
- VS 2022 v17.14.4(安定)では .NET 10 の IDE ビルドは不可。CLI なら可。
- IDE まで含めて試すなら VS 2026(v18)Insiders/Preview を追加インストール。VS 2022 とは共存可能。
- 最小リスクで試すなら「SDK + CLI + VS Code」。
global.jsonでバージョン固定を徹底。 - マルチターゲットや CI 分業で、チーム全体の移行を段階的に進める。
- プレビューはあくまで検証用途。別環境に分離し、バックアップとロールバック手順を用意してから着手する。
付録:コマンド断片集
SDK の導入・確認
winget install --id=Microsoft.DotNet.SDK.Preview -e
dotnet --list-sdks
dotnet --info
テンプレート作成(CLI)
dotnet new console -n HelloNet10 -f net10.0
dotnet new webapi -n SampleApi10 -f net10.0 --use-controllers
dotnet new classlib -n Lib10 -f net10.0
テスト・発行
dotnet new xunit -n Lib10.Tests -f net10.0
dotnet test Lib10.Tests
dotnet publish SampleApi10 -c Release -r win-x64 --self-contained false
global.json(例:マイナーの前方互換を許可)
{
"sdk": {
"version": "10.0.100-rc.2.x",
"allowPrerelease": true,
"rollForward": "feature"
}
}
マルチターゲット(ライブラリ)
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<TargetFrameworks>net9.0;net10.0</TargetFrameworks>
<TreatWarningsAsErrors>false</TreatWarningsAsErrors>
</PropertyGroup>
</Project>
最後に
2025 年 11 月時点では、.NET 10 を Windows でフルに試す最短ルートは「VS 2026(v18)Insiders を別インスタンスで導入」か「SDK+CLI+VS Code」の二強です。VS 2022 のチャネル切り替えは v17 内の動きに留まるため、.NET 10 の IDE サポートを期待して無理に切り替える必要はありません。安定環境を保持しながら検証できる構成を選び、段階的にノウハウと互換性を確認していきましょう。

コメント