コードの構文スタイル: 暗黙的 / 明示的な型指定 ('var' キーワード)

C# 3.0 で導入された暗黙的に型指定されたローカル変数（var キーワードとも呼ばれます）を使用すると、多くのシナリオで読みやすさが向上するため、非常に人気があります。デフォルトでは、JetBrains Rider は var キーワードの使用も推奨していますが、その使用箇所の設定は柔軟に構成できます。たとえば、特定の場合やあらゆる場所で明示的な型を使用することを選択でき、JetBrains Rider は設定を適用できます。

C# 7.0 から、タプルを分解するときにローカル変数を宣言できます。このような宣言で var を使用する場合は、結合表記または区切り表記を使用するようにスタイルを追加で構成できます。例: var (x, y) = GetTuple(); または (var x, var y) = GetTuple();

もう 1 つの C# 7.0 機能は破棄です。これにより、var を使用して、_ という名前のスコープ内の変数との競合がないことを確認することもできます。JetBrains Rider を使用すると、必要に応じて破棄して var を常に使用するようにスタイルを構成できます。

「var」キーワードを使用する設定を強制する

JetBrains Rider はあなたの好みに合っているかどうかすべてのローカル変数をチェックします。もしそれらが遵守していなければ、JetBrains Rider はそのような宣言を強調し、対応するクイックフィックスまたはスコープの修正を提案します。

デフォルトでは、JetBrains Rider の設定では、'var' キーワードが優先されます:

設定を変更すると、JetBrains Rider は明示的なタイプを使用できます:

バルクモードで「var」キーワードの使用の設定を強制する別のオプションは、コードのクリーンアップです。組み込みプロファイルフルクリーンアップまたは再フォーマットして構文スタイルを適用のいずれかを使用してコードクリーンアップを実行するか、以下で説明するように、特定のタスクのみを対象としたカスタムプロファイルを作成して実行できます。

カスタムコードクリーンアッププロファイルで「var」キーワードを使用する設定を適用する

Ctrl+Alt+S を押すか、メニューからファイル | 設定 (Windows および Linux) または JetBrains Rider | 環境設定 (macOS) を選択します。
クリーンアッププロファイル設定ページに移動します: エディター | コードのクリーンアップ。
新しいカスタムクリーンアッププロファイルを作成するセクションの説明に従って新しいプロファイルを作成します。右側のプロファイル設定で、構文スタイルを適用する | C# ノードを展開し、'var' スタイルを適用チェックボックスをオンにします。
設定ダイアログで保存をクリックして変更を適用し、JetBrains Rider が変更を保存する場所を選択できるようにするか、保存セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「レイヤーベースの設定」を参照してください。
設定を適用する範囲を選択します。
- ファイル内の任意の場所にキャレットを配置して、ファイルに設定を適用します。
- ソリューションエクスプローラー内の 1 つまたは複数の項目を選択して、これらのノードおよびその子項目にあるファイルに設定を適用します。
Ctrl+R, C を押すか、メインメニューからコード | 再フォーマットとクリーンアップ…を選択してください。
開いたコードの再フォーマットとクリーンアップダイアログで、新しく作成したプロファイルを選択し、必要に応じて別のスコープを選択します。
OK をクリックします。JetBrains Rider は選択した範囲内であなたの設定を強制します。

コードの再フォーマットとクリーンアップダイアログを開いてプロファイルを選択せずに、'var' キーワードの使用設定を強制する場合は、作成したプロファイルをサイレントクリーンアップにバインドし、Ctrl+R, G を押して実行できます。設定の適用と他のコードスタイルタスクを組み合わせたカスタムクリーンアッププロファイルを作成することもできます。

'var' キーワードの使用設定を、他のすべてのフォーマットおよび構文スタイルの規則とともに、選択したコードブロック Alt+Enter に適用し、再フォーマットとクリーンアップ | 構文スタイルを再フォーマットして適用するを選択します。

最近変更し、Git にコミットしようとしているコードで、「var」キーワードの使用箇所の設定を適用できます。JetBrains Rider は、コミットする前に、選択したクリーンアッププロファイルを実行します。

Git にコミットする前にコードをクリーンアップする

Ctrl+K を押すか、メインメニューから Git | コミットを選択します。
コミットツールウィンドウでをクリックし、コミットチェック領域でクリーンアップ ... チェックボックスを選択します。
プロファイルの選択をクリックして、カスタムコードクリーンアッププロファイルを選択します。
コミットまたはコミットとプッシュをクリックします。JetBrains Rider は、コミット用にステージングされたファイルでコードのクリーンアップを実行し、変更をコミットします。

変更をファイルに保存するたびに「var」キーワードの使用箇所の設定を適用して、編集が常にコードスタイルに準拠するようにすることができます。これは、変更を Ctrl+S または Ctrl+S で明示的に保存した場合にのみ発生し、auto-saving によってトリガーされないことに注意してください。ただし、自動保存されたすべてのファイルは「再フォーマットおよびクリーンアップ」キューに配置され、次の明示的な保存で処理されます。

変更の保存時に「var」キーワードの使用の設定を自動的に適用する

Ctrl+Alt+S を押して設定を開き、ツール | 保存時のアクションを選択します。
コードの再フォーマットとクリーンアップを選択し、カスタムコードクリーンアッププロファイルを選択して、それをファイル全体に適用するか、変更された行のみに適用するかを選択します。
次に編集を終了してファイルまたはすべてのファイルを保存すると、JetBrains Rider は選択されたプロファイルを使用して影響を受けるファイルをクリーンアップします。

'var' キーワードを使用するための環境設定を構成する

'var' キーワードの使用設定は、レイヤーベースの設定の仕組みを使って保存されます。とりわけ、このメカニズムにより、さまざまなソリューションのさまざまな設定を維持したり、これらの設定を VCS に保持したり、チームメンバーと自動的に共有することができます。

設定 / 環境設定で「var」キーワードを使用する設定を構成するダイアログ

JetBrains Rider 設定 Ctrl+Alt+S のエディター | コードスタイル | C# ページに移動し、構文スタイルタブを選択します。
宣言における 'var' の使用箇所カテゴリの設定を、コーディングのプラクティス / 標準に従って変更します。
タイプごとに 'var' または明示的なタイプを使用する異なる設定を設定できます。
- ビルトインタイプの場合 — C# ビルトインタイプに適用されます。
- 単純型の場合 — ジェネリクスパラメーターのない型に適用されます。
- 他の場所 — ジェネリクス型と脱構築宣言に適用されます。
これらの設定ごとに、「var」、明示的なタイプ、明らかなときに 'var' の使用を選択できます。
前の手順で明確な場合は 'var' を使用するを選択した場合は、Visual Studio ロジックを適用して、どのケースを明白と見なすかを決定できます。
JetBrains Rider ロジックと Visual Studio ロジックの違いについては、「明確な場合は 'var' を使用する: 明らかと考えられるものは何ですか？」を参照してください。
デフォルトでは、JetBrains Rider は、var (x, y) = GetTuple(); などの分解宣言で複数の var の結合表記を提案します。展開された変数の宣言を別にすることを選択して、(var x, var y) = GetTuple(); などの個別の表記を選択できます。
デフォルトでは、JetBrains Rider は、破棄にスタンドアロン _ を使用することを提案します（例: (_, _) = (0, 1);）。破棄には 'var' キーワードを使用するを選択して、必要に応じて破棄を伴う var を常に使用することで、_ という名前のスコープ内の変数との競合がないことを確認できます。
右側の列のセレクターを使用すると、設定とは異なるコードインスペクション検出コードの重大度レベルを設定できます。
設定ダイアログで保存をクリックして変更を適用し、JetBrains Rider が変更を保存する場所を選択できるようにするか、保存セレクターからこのレイヤーを選択して特定の設定レイヤーに変更を保存します。詳細については、「レイヤーベースの設定」を参照してください。

また、エディターで 'var' キーワードを使用することの好みを変更することもできます。該当する問題がハイライトされます:

エディターから「var」キーワードを使用する設定を変更する

JetBrains Rider のインスペクションでハイライトされているコードの問題にキャレットを置きます。
Alt+Enter を押すか、キャレットの左側にあるアクションインジケーターをクリックして、アクションリストを開きます。
アクションリストで、インスペクション「優先される 'var' スタイルを使用してください」 | コードスタイルを設定するに移動して、希望の設定を選択します。
変更は、スマートセーブロジックを使用して保存されます。
変更したスタイル設定を共有設定レイヤーに保存する必要がある場合は、コードスタイルを設定するメニュー項目をクリックするか、選択時に Enter を押します。JetBrains Rider により、JetBrains Rider 設定のエディター | コードスタイル | C# | 構文スタイルページが開きます。必要に応じて設定を変更し、保存先をクリックして、目的の設定レイヤーを選択します。

EditorConfig を介して構文スタイルの設定を行うことができます。これらの設定は、ソリューション階層の異なるレベルの .editorconfig ファイルに保存できます。これらのファイルは通常、VCS に配置され、そこで定義された設定がプロジェクトチーム間で共有されます。

JetBrains Rider では、EditorConfig を使用して、JetBrains Rider の設定ダイアログで利用可能な構文スタイル設定を定義できます。サポートされている EditorConfig プロパティの名前と説明は、EditorConfig リファレンスで確認できます。

.editorconfig ファイルで定義された構文スタイルプロパティは、この .editorconfig ファイルが適用されるスコープ内の JetBrains Rider 設定で定義された同じプロパティをオーバーライドすることに注意することが重要です。

EditorConfig を使用して「var」キーワードの使用に関する設定を構成する

目的の .editorconfig ファイルを開きます。
必要な「var」キーワードの使用箇所のプロパティをファイルに追加します。例:
for_built_in_types = use_var_when_evident

明確な場合は 'var' を使用する: 明らかと考えられるものは何ですか？

「var」キーワードと明示的なタイプを使用する設定を構成する場合、明確な場合は 'var' を使用するを選択できます。このオプションは自明のように見えますが、場合によっては「明らか」と見なされるものとそうではないものが不明な場合があります。

それとは別に、両方の製品が「var」キーワードまたは明示的な型の使用を提案する場合、JetBrains Rider と Visual Studio によって明白（明白）と見なされるものの間にはいくつかの違いがあります。

次の表は、JetBrains Rider 設定 Ctrl+Alt+S のエディター | コードスタイル | C# | 構文スタイルページの型の証拠には Roslyn（Visual Studio）ロジックを優先するチェックボックスの状態に応じて、'var' として宣言できる初期化子が明らかと見なされる場合を示しています。

初期化式	サンプル	オフ	オン
オブジェクト作成式	`new MyClass()`	明らか	明らか
キャスト式	`(MyClass) obj`	明らか	明らか
`as` 式	`obj as MyClass`	明らか	明らか
リテラル式	`"some string literal"` `123` `true`	明らか	明らか
デフォルトの式	`default(MyClass)`	明らか	明らか
タプル式	`(1, 2, 3)`	すべてのコンポーネント式が明らかな場合に明らか
明示的な配列作成式	`new int[] { 1, 2, 3 }` `new MyClass[5]`	明らか	明らか
暗黙的な配列作成式	`new [] { 1, 2, 3}` `new [,] { {1, 2, 3}, {1, 2, 3}, {1, 2, 3} }`	すべての要素初期化子（最大 42）が明らかな場合に明らか	明らかではない
非ジェネリクスファクトリ（作成）メソッド (ある型で宣言され、同じ型の値を返す静的メソッド)	`MyClass.Build(someArgs) // returns MyClass`	メソッド名に親タイプ名または次の部分文字列のいずれかが含まれている場合に明らか: 「作成」、「ビルド」、「構築」、「作成」、「生成」、「生成」、「新規」、「インスタンス」	明らか
一般的なファクトリ（作成）メソッド (ジェネリクス型を返し、戻り型と同じ名前のクラスで宣言された静的メソッド)	`Tuple.Create(1, 2, 3)`	すべてのメソッド呼び出し引数が明白であり、メソッド名に次の部分文字列の 1 つまたはクラス名が含まれている場合に明らか: 「作成」、「ビルド」、「構築」、「作成」、「生成」、「生成」、「新規」、「インスタンス」	明らか
変換方法 (「To」に戻り型の名前を加えた名前のメソッド)	`obj.ToString()` `enumeration.ToList()`	戻り値の型がジェネリクスでない場合に明らか	明らか
型引数の値を返す明示的な型引数を持つジェネリクスメソッド	`obj.GetValue<MyClass>() // returns MyClass`	明らか	明らかではない
列挙型メンバー	`KnownColor.Azure`	明らか	明らかではない
シングルトンフィールド (宣言されている型の値を返す静的 / 定数フィールド)	`int.MaxValue` `string.Empty`	フィールド名にタイプ名または次の部分文字列のいずれかが含まれている場合に明らか: 「空」、「インスタンス」、「デフォルト」、「値」	明らかではない

2026 年 3 月 03 日

JetBrains Rider 2026.1 ヘルプ