CursorでのC#開発:Dev Kitセットアップガイド
CursorでのC#および.NET開発は絶対に可能ですが、いくつかのセットアップが必要です。C# Dev Kit拡張機能は、IntelliSense、デバッグ、プロジェクトのスキャフォールディングなど、Visual StudioのようなツールをCursorに提供します。正しい設定があれば、本番環境で使える開発体験が得られます。本ガイドは、35件の返信を持つディスカッションスレッドのコミュニティ経験に基づいて、必要なすべてをカバーします。
前提条件
C# Dev Kitをインストールする前に、以下を確認してください:
- Cursor がインストールされている(バージョン0.40以上を推奨)
- .NET SDK がインストールされている(dotnet.microsoft.comからダウンロード)
- C#および.NETプロジェクト構造の基本的な理解
.NETのインストールを確認します:
dotnet --version
8.0.100または9.0.100のようなバージョン番号が表示されるはずです。失敗した場合は、まず.NET SDKをインストールしてください。
C# Dev Kit拡張機能のインストール
ステップ1:拡張機能パネルを開く
Cursorで、Ctrl+Shift+X(macOSではCmd+Shift+X)を押して拡張機能マーケットプレイスを開きます。
ステップ2:C# Dev Kitを検索
検索ボックスにC# Dev Kitと入力します。Microsoftの公式拡張機能を探します:
公開者:Microsoft
拡張機能ID:ms-dotnettools.csdevkit
ステップ3:インストール
インストール をクリックします。Cursorは拡張機能とその依存関係をダウンロードしてインストールします:
- C#拡張機能(IntelliSense、シンタックスハイライト)
- .NETインストールツール
- IntelliCode for C# Dev Kit
インストールボタンがグレーアウトしているか、拡張機能が表示されない場合は、Cursorが最新バージョンに更新されていることを確認してください。一部の古いCursorバージョンは、最新のC# Dev Kitとの互換性に問題があります。
ステップ4:Cursorをリロード
インストールが完了すると、ウィンドウをリロードするプロンプトが表示されます。リロード をクリックして拡張機能を有効化します。
最初の.NETプロジェクトをセットアップ
新しいプロジェクトを作成
C# Dev Kitがインストールされると、いくつかの方法でプロジェクトを作成できます。
オプション1:コマンドパレットを使用
Ctrl+Shift+P(macOSではCmd+Shift+P)を押す.NET: New Projectと入力- プロジェクトテンプレートを選択(コンソールアプリ、Web API、クラスライブラリなど)
- プロジェクトの場所と名前を選択
オプション2:ターミナルを使用
# 新しいコンソールアプリケーションを作成
dotnet new console -n MyCursorApp
# プロジェクトディレクトリに移動
cd MyCursorApp
# Cursorで開く
cursor .
オプション3:ソリューションエクスプローラーを使用
C# Dev Kitは、Cursorにソリューションエクスプローラーパネルを追加します。空白領域を右クリックして 新しいプロジェクトを作成 を選択できます。
プロジェクト構造
典型的な.NETコンソールプロジェクトは以下のようになります:
MyCursorApp/
├── MyCursorApp.csproj # 依存関係を含むプロジェクトファイル
├── Program.cs # エントリーポイント
└── obj/ # ビルド成果物(自動生成)
.csprojファイルは、NuGetパッケージとプロジェクト設定を管理する場所です:
<Project Sdk="Microsoft.NET.Sdk">
<PropertyGroup>
<OutputType>Exe</OutputType>
<TargetFramework>net8.0</TargetFramework>
<ImplicitUsings>enable</ImplicitUsings>
<Nullable>enable</Nullable>
</PropertyGroup>
</Project>
長期サポート(LTS)にはnet8.0を、最新機能にはnet9.0を使用してください。C# Dev Kitは両方をサポートしています。
NuGetパッケージを追加
ソリューションエクスプローラーまたはターミナルからパッケージを追加できます:
# Entity Framework Coreを追加
dotnet add package Microsoft.EntityFrameworkCore.SqlServer
# Newtonsoft.Jsonを追加
dotnet add package Newtonsoft.Json
# ASP.NET Coreを追加
dotnet add package Microsoft.AspNetCore.App
CursorでC#をデバッグ
デバッグはC# Dev Kitが真に輝く場所です。ブレークポイント、ステップ実行、変数の検査、コールスタックのナビゲーションが利用できます。
起動構成
初めてF5を押してデバッグすると、Cursorはlaunch.jsonファイルの作成を求めます。ドロップダウンメニューから .NET Core を選択します。
これにより.vscode/launch.jsonが作成されます:
{
"version": "0.2.0",
"configurations": [
{
"name": ".NET Core Launch (console)",
"type": "coreclr",
"request": "launch",
"preLaunchTask": "build",
"program": "${workspaceFolder}/bin/Debug/net8.0/MyCursorApp.dll",
"args": [],
"cwd": "${workspaceFolder}",
"console": "internalConsole",
"stopAtEntry": false
},
{
"name": ".NET Core Attach",
"type": "coreclr",
"request": "attach"
}
]
}
また、ビルドタスク用の.vscode/tasks.jsonも必要です:
{
"version": "2.0.0",
"tasks": [
{
"label": "build",
"command": "dotnet",
"type": "process",
"args": [
"build",
"${workspaceFolder}/MyCursorApp.csproj"
],
"problemMatcher": "$msCompile"
}
]
}
ブレークポイントを設定
任意の行番号の横の余白をクリックしてブレークポイントを設定します。C# Dev Kitは以下をサポートしています:
- 標準ブレークポイント
- 条件付きブレークポイント(ブレークポイントを右クリック)
- ログポイント(停止せずにログを記録するブレークポイント)
デバッグ機能
| 機能 | アクセス方法 | 備考 |
|---|---|---|
| デバッグ開始 | F5 | デバッガーをアタッチして実行 |
| ステップオーバー | F10 | 現在の行を実行し、次の行に移動 |
| ステップイン | F11 | 関数呼び出しに入る |
| ステップアウト | Shift+F11 | 現在の関数から戻る |
| 変数をウォッチ | デバッグパネル > ウォッチ | 監視する式を追加 |
| コールスタック | デバッグパネル > コールスタック | 実行スタックをナビゲート |
| 変数を検査 | 変数にホバー | インライン値表示 |
デバッグが開始されない場合は、launch.jsonのprogramパスが実際の出力DLLパスと一致しているか確認してください。プロジェクトの名前を変更したり、ターゲットフレームワークを変更したりすると、パスが変わります。
VS Code拡張機能の互換性
CursorはVS Codeをベースにしているため、ほとんどのVS Code拡張機能はそのまま動作します。ただし、C#エコシステムにはいくつかのニュアンスがあります。
互換性のある拡張機能
| 拡張機能 | 用途 | ステータス |
|---|---|---|
| C# Dev Kit | コアC#ツール | 完全サポート |
| IntelliCode for C# Dev Kit | AI支援補完 | 利用可能 |
| .NET Install Tool | SDK管理 | 利用可能 |
| NuGet Gallery | パッケージブラウジング | 利用可能 |
| REST Client | APIテスト | 利用可能 |
既知の互換性の問題
コミュニティスレッドの一部のユーザーは、時々問題を報告しています:
-
ソリューションエクスプローラーが読み込まれない:ソリューションエクスプローラーパネルが空のままになることがあります。修正方法:ウィンドウをリロード(
Ctrl+Shift+P>Developer: Reload Window)。 -
IntelliSenseの遅延:大規模なソリューションでは、IntelliSenseの初期化に数秒かかることがあります。初回ロード時にはこれは正常です。
-
テストエクスプローラー:組み込みのテストエクスプローラーがテストをすぐに検出しないことがあります。フォールバックとして、ターミナルから
dotnet testを実行します。
# すべてのテストを実行
dotnet test
# 詳細出力でテストを実行
dotnet test --verbosity normal
# 特定のテストクラスを実行
dotnet test --filter "FullyQualifiedName~MyTestClass"
追加のVS Code拡張機能を使用
C#開発を補完する他のVS Code拡張機能をインストールできます:
- GitLens —— 強化されたGit統合
- Error Lens —— インラインエラー表示
- Bracket Pair Colorizer —— 括弧の一致を視覚化
- XML Tools ——
.csprojおよび.configファイルの編集用
ASP.NET Coreを使用
C# Dev KitはASP.NET Coreプロジェクトを完全にサポートしています。以下はクイックセットアップです:
# 新しいWeb APIプロジェクトを作成
dotnet new webapi -n MyApi
cd MyApi
cursor .
ソリューションエクスプローラーにコントローラー、モデル、および設定ファイルが表示されます。デバッグ方法は同じ —— F5を押すと、デバッガーがアタッチされた状態でAPIが起動します。
Web APIプロジェクトでは、launch.jsonを統合ターミナルを使用するように更新したい場合があります:
{
"name": ".NET Core Launch (web)",
"type": "coreclr",
"request": "launch",
"preLaunchTask": "build",
"program": "${workspaceFolder}/bin/Debug/net8.0/MyApi.dll",
"args": [],
"cwd": "${workspaceFolder}",
"console": "integratedTerminal",
"env": {
"ASPNETCORE_ENVIRONMENT": "Development"
}
}
CursorでC#を使用するベストプラクティス
1. .editorconfigを使用
プロジェクトのルートに.editorconfigファイルを作成して、一貫したフォーマットを強制します:
root = true
[*.cs]
indent_style = space
indent_size = 4
csharp_new_line_before_open_brace = all
csharp_prefer_braces = true
dotnet_sort_system_directives_first = true
2. OmniSharp設定を構成
C#言語サーバーを調整する必要がある場合は、Cursorのsettings.jsonに設定を追加します:
{
"omnisharp.enableRoslynAnalyzers": true,
"omnisharp.enableEditorConfigSupport": true,
"omnisharp.organizeImportsOnFormat": true
}
3. CursorのAIをC#と組み合わせて使用
CursorのAI機能はC#とうまく機能します。いくつかの効果的なプロンプト:
"このEntity Framework Coreモデルのリポジトリパターン実装を、
非同期CRUD操作を含めて生成してください。"
"このコントローラーを、直接のサービス呼び出しの代わりに
MediatRコマンドを使用するようにリファクタリングしてください。"
"このDTOクラスにFluentValidationを使用して入力検証を追加してください。"
4. SDKを最新に保つ
C# Dev Kitは最新の.NET SDKバージョンと最もうまく機能します。定期的に更新を確認します:
dotnet --list-sdks
dotnet --version
5. マルチプロジェクト設定にはソリューションファイルを使用
複数のプロジェクトを含むソリューションには、.slnファイルを作成します:
dotnet new sln -n MySolution
dotnet sln add MyApi/MyApi.csproj
dotnet sln add MyApi.Tests/MyApi.Tests.csproj
C# Dev Kitのソリューションエクスプローラーは、すべてのプロジェクトとその依存関係を表示します。
一般的なトラブルシューティング
| 問題 | 解決策 |
|---|---|
| ".NET SDKが見つかりません" | .NET SDKをインストールしてCursorを再起動 |
| IntelliSenseが機能しない | ウィンドウをリロードするか、OmniSharpログを確認(Ctrl+Shift+P > OmniSharp: Show Output) |
| 参照が不足してビルドが失敗 | ターミナルでdotnet restoreを実行 |
| デバッガーがアタッチできない | launch.jsonのprogramパスが出力DLLと一致しているか確認 |
| 大規模ソリューションの起動が遅い | 設定でbin/およびobj/フォルダをファイル監視から除外 |
C#言語サーバーが繰り返しクラッシュする場合は、競合を分離するために一時的に他の拡張機能を無効にしてみてください。C# Dev Kitは、C#言語プロバイダーとして登録する古い拡張機能と競合する可能性があります。
まとめ
C# Dev Kitをインストールしてプロジェクトを正しく構成すれば、CursorでのC#開発は本番環境で使用できます。完全なIntelliSense、デバッグ、プロジェクト管理、およびNuGetパッケージサポートが得られます。ワークフローはVisual Studioに近く、CursorのAI機能が追加されています。
主なポイント:
- 公式のMicrosoft C# Dev Kit拡張機能をインストール
dotnet newまたはソリューションエクスプローラーを使用してプロジェクトをスキャフォールディング- デバッグ用に
launch.jsonおよびtasks.jsonを構成 - 最適な互換性のために.NET SDKを最新に保つ
- 一貫したコードスタイルのために
.editorconfigを使用
この設定により、CursorはMicrosoftのC#ツールとCursorのAI支援コーディング機能を組み合わせた、強力な.NET開発IDEとなります。