Visual Studioのコードレンズを非表示！画面を広く使う設定

コードを書くとき、Visual Studioのコードレンズがクラスやメソッドの上に表示されて邪魔に感じることがあります。画面が狭く見える、コードの集中が妨げられる、という理由で「Visual Studio コードレンズ 非表示」を検索する方が多いです。この記事では、コードレンズを部分的にまたは完全に非表示にする方法をステップバイステップで解説します。最新情報をもとに、設定場所・選択肢・注意点を詳しく紹介します。画面を広くし、コーディング体験を改善しましょう。

Visual Studio コードレンズ 非表示の基本設定

Visual Studioでコードレンズを非表示にする最も基本的な方法は、ツール内の設定でコードレンズを無効化することです。これにより、コード要素（クラス、メソッドなど）の上に表示される参照カウントや作成者情報などが一括で非表示になります。すべての言語で共通の設定として機能し、IDEの画面表示がすっきりします。最新のVisual Studioではこの設定が明示的に用意されています。

設定の場所は「ツール → オプション → テキスト エディタ → All Languages → CodeLens」です。ここで「CodeLensを有効にする」のチェックを外すだけで非表示化が完了します。表示と非表示を切り替え可能であり、再度オンにしたいときも同じ箇所で操作できます。画面の視認性や集中力を高めたい場合には第一選択にしたい設定です。

コードレンズの種類を見分ける

コードレンズには参照（References）、変更履歴、Unit Test 状態、作業項目とのリンクなど複数の種類があります。非表示にしたい要素がどれかを理解することが設定の際に重要です。全てを非表示にしたい場合は一律オフにするのが簡単ですが、特定の種類のみ非表示にすることは制限があることがあります。

特に参照（References）はコードレンズの中心的な要素であり、多くの場合オフにできないか、設定がグレーアウトされていることがあります。これは参照数が将来的に追加される可能性に備えてUIのスペースを確保するためです。そのため、部分的な制御は限られていると理解しておく必要があります。

Visual Studioのバージョンによる違い

Visual StudioはバージョンごとにUIや設定可能項目が変化しており、コードレンズ周りも例外ではありません。Visual Studio 2019までは参照をオフにする選択肢が制限されていたり、特定の言語のみ有効にできなかったりすることがあります。最新版ではオプションが増え、細かく制御できるようになっています。

たとえば、Visual Studio 2022のバージョン17.12以降では、ファイルレベルのコードレンズインジケーターを非表示にするオプションが追加され、HTML／XAML／CSSなどのファイルタイプで下部スクロールバー上の表示を切り替えることが可能になっています。このようにバージョンに応じて設定項目を確認することが大切です。

画面を広く使えるメリット

コードレンズを非表示にすると得られるメリットとして、コード本体の可視領域が増えることが挙げられます。特にノートパソコンや小さなディスプレイを使っている場合、コードレンズが数行を占有するだけでスクロール量が増えることがあります。

視覚的に余白が減ることで、コードの構造が読みやすくなります。ライティング中の誤タップや誤クリックが減り、集中力を保ちやすくなるため、生産性が向上するという利用者の声も多いです。デザインやUI作業を主に行う場合は無くしてしまうことでストレス軽減につながります。

選択的に部分的にVisual Studio CodeLens 非表示にする方法

コードレンズを完全に消すのではなく、特定の要素だけ非表示にしたい場合もあります。参照だけを隠したい、ファイルレベルのインジケーターだけオフにしたい、というニーズに応える設定はいくつかあります。最新の環境ではこのような選択が可能になっています。

大きく分けると、言語別制御、ファイルタイプ別の表示制御、スクロールバー上のファイルレベルインジケーター制御があります。これらを組み合わせることで、欲しい情報だけ見えて欲しくない情報を隠すことができます。以下でそれぞれケース別に解説します。

言語・要素別に制御

参照やテスト、作業項目などの種類別にコードレンズ表示を制御したい際には、CodeLensオプション内の設定を使います。「Text Editor → All Languages → CodeLens」内のサブ設定から、どの種類のインジケーターを表示するかを選択できます。ただし一部の要素は無効にできない場合があり、その場合は代替策としてフォント・色・サイズを調整して視認性を下げる方法があります。

言語特定の設定も可能で、例えば C# や Visual Basic は特定の言語セットアップで参照インジケーターを管理できます。これにより、他の言語ファイルにはコードレンズを残しつつ、主に使用する言語でのみ表示を抑制することができます。

ファイルタイプに応じた非表示設定

ファイルの拡張子が xaml/html/css などのリソースファイルである場合、これらにはファイルレベルのコードレンズが適用されるケースがあります。編集中に画面下部に表示されるファイル全体の変更履歴やソース管理状態など、これらを非表示にするオプションがあります。

Visual Studio 2022では「Show file level CodeLens indicator」という項目が用意されており、設定画面の「Text Editor → Advanced」内にあります。これをオフにすることで、ファイルレベルのインジケーターをスクロールバー上から非表示にできます。コード要素レベルの表示には影響しません。

フォント・色・スタイルで「擬似非表示」にするコツ

完全にオフにできない参照表示などを見えなくしたい場合、フォントや文字色、サイズを調整して目立たなくする方法があります。背景に近い色に設定することで、見えるはずの情報を極力目立たせないようにできます。

Visual Studio の「環境 → フォントと色」内で CodeLens のテキストや区切り文字の色を背景と同一または類似色に設定でき、フォントサイズや種類も調整可能です。完全に消すわけではないものの、画面のノイズを減らすには有効な方法です。

Visual Studio CodeLens 非表示を巡る注意点とトラブル対策

コードレンズを非表示にする一方で注意すべき点もあります。使っているVisual Studioのエディション・設定によっては非表示にできない要素があったり、設定後に再起動やソリューションの再ビルドが必要な場合があります。表示が消えないときの対処法を理解しておくと安心です。

特に参照インジケーターは完全にオフにできないケースがあります。また、ソース管理連携やプラグインがコードレンズ情報を別経路で描画していると、標準設定だけでは非表示にならないことがあります。それを踏まえた対策を以下で紹介します。

エディションや機能制限

Visual Studio の Community／Professional／Enterprise の各エディションには機能差があります。ソース管理に関するインジケーターなど一部のコードレンズ表示はエディションに応じて表示できないものがあったり、表示をオフにできない仕様になっていることがあります。

また、言語やプロジェクトタイプ（.NET、SDKスタイル、古いプロジェクト形式など）によって、どの種類の情報がコードレンズ対応か異なります。使用中の環境でどこまで制御できるかは設定画面で確認する必要があります。

再起動と再ビルドの問題解消

設定を変更してもすぐにコードレンズが消えないことがあります。その場合は、Visual Studioを再起動したりソリューションをクリーンして再ビルドすることで解決することが多いです。キャッシュ情報が残っていたり、プロジェクトの解析が終わっていないことが原因となるためです。

特にファイルレベルのインジケーターを消したあとにはエディター表示の更新が必要なケースがあり、変更後の再起動や特定の画面を開き直すことで設定が反映されることがあります。

拡張機能が影響しているケース

CodeLens表示とは別に、拡張機能が似たような参照表示や履歴表示を自前で追加していることがあります。これらが有効なままだと、標準のコードレンズをオフにしても画面上に類似の情報が表示され続けることがあります。

そのような場合は全ての拡張機能を一時的に無効にして表示が消えるか確認し、有効な拡張を一つずつ復帰させてどれが表示を生み出しているかを特定します。それを非表示または設定でオフにすることで対応できます。

Visual Studio CodeLens 非表示設定の具体的な手順

実際に「Visual Studio コードレンズ 非表示」するための具体的な手順を、最新のVisual Studioに基づいて解説します。設定画面を探す方向性と、それぞれのケースに応じた選び方を理解して操作できるようになります。

以下の手順で設定を変えていき、必要に応じてフォントや言語ごとの調整も活用してください。画面表示のスッキリ感が劇的に改善するはずです。

手順1：CodeLensを完全にオフにする

まず画面を広く使いたいならコードレンズ全体を無効化する手順です。Visual Studioのメニューから「ツール → オプション」を開き、「テキストエディタ → All Languages → CodeLens」の順で進みます。その中にある「CodeLensを有効にする」のチェックを外すことで、すべての言語とすべての種類のコードレンズが一括で非表示になります。設定後はIDEを再起動すると確実に反映されます。

手順2：ファイルレベルのインジケーターを非表示にする

次にファイルタイプ別、特にHTML／XAML／CSSなどのリソースファイルで表示されるファイルレベルのインジケーターだけを非表示にする手順です。Visual Studioのバージョンが最新であれば、「テキスト エディタ → 詳細設定」内に「Show file level CodeLens indicator」という設定があります。これをオフにすることで、スクロールバー下部に表示されるファイル全体のインジケーターを非表示にできます。コード要素レベルの表示には影響しません。

手順3：参照だけを目立たなくする工夫

参照カウンターなど一部の表示がどうしても残ってしまう場合は、フォント・色・サイズを調整して視認性を下げる方法があります。「環境 → フォントと色」の設定で CodeLens 関連項目を選び、テキスト色や区切り文字の色を背景と近いものに変更し、フォントサイズを小さくすることで目立たなくなります。完全には見えなくなりませんが、視覚的ノイズを大幅に軽減できます。

Visual Studio コードレンズ 非表示にする際の比較表

用途別に「完全非表示」「部分的非表示」「見えなくする調整」の比較を表にまとめます。状況に応じて最適な設定を素早く選べるように参考にしてください。

よくある質問と疑問への回答

Visual Studio コードレンズ 非表示にする際、ユーザーからよく寄せられる疑問とその回答をまとめます。設定後困らないようにここで確認しておきましょう。

参照インジケーターだけ非表示にできるか

参照インジケーター（References）のみを完全に非表示にすることは、通常の設定では不可能な場合があります。多くの場合、この要素はコードレンズの中核であり、UIの一貫性維持のため無効にできない仕様となっていることがあります。完全に消したい場合は、見えにくい色に変更する、フォントを非常に小さくするなどの工夫が必要です。

設定が反映されないときの対処方法

チェックを外したにも関わらずコードレンズが残る場合、IDEの再起動、ソリューションのクリーンビルド、キャッシュのクリアなどが効果的です。設定後にファイルを再度開き直すことや、Visual Studio の更新プログラムを適用して最新の状態にしておくことも重要です。

拡張機能がコードレンズ表示を追加している可能性

拡張機能が標準 CodeLens とは別で類似機能を持っていることがあります。標準設定で消えていない表示は、それらの拡張機能によるものかもしれません。すべての拡張を一時的に無効にして表示を確認し、原因を絞ることで対応できます。

バージョンが古いVisual Studioを使っている場合の注意

古いバージョンのVisual Studioではコードレンズの設定項目が限定的で、参照の種類や言語ごとの制御が不十分なことがあります。最新版に更新することで新しい設定オプションが追加されているケースが多いため、アップデート可能なら更新を検討する価値があります。

まとめ

Visual Studioでコードレンズを非表示にすることで、画面を広く使いコードの可視性や集中が劇的に向上します。完全にオフにする方法、ファイルレベルや参照だけを抑える方法、視認性を下げる調整など、多数の手段があります。どの方法が最も適しているかは使用環境・言語・プロジェクトタイプによります。

特に最新バージョンではファイルレベルのインジケーター部分の制御が追加されており、最低限の表示で済ませたいユーザーにも柔軟に対応できるようになっています。拡張機能の影響やキャッシュの残存など細かい注意点にも気をつけて、快適なコーディング環境を実現してください。