Visual StudioでVB（Visual Basic）のモジュールを別プロジェクトへコピー＆ペーストしたら、先頭に大量のImportsが自動で追加されて困ったことはありませんか？原因はエディターの補助機能です。本記事では挙動を止める設定手順と、設定が効かない場合の確認ポイントをまとめます。
症状：貼り付けるたびにファイル先頭へImportsが増える
VBの標準モジュール（Module）やクラスを、別プロジェクトへコピー＆ペーストしたときに、Visual Studioがコードの先頭へ多数のImports文を自動挿入することがあります。たとえば、貼り付け前は最小限のImportsだけだったのに、貼り付け後に「いつの間にか増えた」状態になり、差分が見づらくなったり、レビューで突っ込まれたりします。
| 困りごと | 具体的に起きること | 実務での影響 |
|---|---|---|
| 差分がノイズになる | 貼り付けただけで多数の行が追加される | PR/コードレビューの負荷が増える |
| 意図しない依存が見えづらい | 「どの名前空間に依存しているか」が膨らむ | 移植・分割・共通化の判断が鈍る |
| 名前衝突の火種 | 同名型が複数の名前空間に存在すると曖昧になる | ビルド失敗や、将来の不具合につながる |
本来は「必要なImportsが足りなければコンパイルエラーで気づきたい」「貼り付け時にIDEが勝手に書き換えないでほしい」という運用も多いはずです。ここでは、まず公式に案内されている基本設定でこの挙動を止める方法を解説します。
なぜ自動でImportsが追加されるのか
Visual Studioには、貼り付けたコードがすぐに動く（少なくとも名前解決ができる）ように、必要になりそうな名前空間を推測してImportsを補完する機能があります。VBはC#のusingと同じく、型名を短く書ける一方で、貼り付け先プロジェクトの参照状況や既定のインポート設定によって、必要な名前空間が変わることがあります。
この機能は、特に次のようなケースで「ありがた迷惑」になりやすいです。
- 移植先プロジェクトで、意図的に
Importsを最小化している（規約・静的解析・レビュー方針） - 共通ライブラリ化のために、依存関係を明確にしたい
- 同名クラス（例：
FileやTaskなど）が複数の名前空間にあり、安易に追加されると曖昧参照になり得る - 「貼り付けた瞬間は通るが、プロジェクト参照が不足して結局ビルドが通らない」など、結果として手直しが必要
よくある追加例（イメージ）
実際に追加される内容は貼り付けたコードに依存しますが、次のように複数の行がまとまって入ることがあります。
Imports System
Imports System.Collections.Generic
Imports System.IO
Imports System.Linq
Imports System.Text
Imports System.Threading.Tasksここで注意したいのは、「追加されたからといって、それが本当に必要とは限らない」という点です。貼り付け時点の推測で入るため、貼り付け後にコードを少し直しただけで未使用になってしまうImportsも混ざりがちです。
解決策：貼り付け時に不足しているImportsを自動追加する機能をオフにする
Visual Studioのオプションにある 「貼り付け時に不足しているImportsを追加」 を無効にすると、貼り付けてもIDEが勝手にImports文を増やさなくなります。必要なImportsが足りない場合は、あなたの期待どおりコンパイルエラー（またはエディター上のエラー表示）で検出できます。
設定場所（英語UI / 日本語UIの見え方）
| 項目 | 英語UI表記 | 日本語UI表記（例） |
|---|---|---|
| メニュー | Tools > Options | ツール > オプション |
| ツリー | Text Editor > Visual Basic > Advanced | テキスト エディター > Visual Basic > 詳細 |
| セクション | Import Directives | インポート ディレクティブ |
| チェック項目 | Add missing imports on paste | 貼り付け時に不足している Imports を追加 |
設定手順（手順どおりに進めればOK）
- Visual Studioのメニューから ツール（Tools） > オプション（Options） を開きます。
- 左側のツリーで テキスト エディター（Text Editor） > Visual Basic > 詳細（Advanced） を開きます。
- インポート ディレクティブ（Import Directives） 付近にある Add missing imports on paste（貼り付け時に不足している Imports を追加）のチェックを外します。
- OKで閉じ、念のためVisual Studioを再起動します。
設定後に期待できる挙動
- モジュールを貼り付けても、ファイル先頭に
Importsが自動で増えない - 必要な参照や
Importsが不足していれば、コンパイルエラーやエディターの赤線で気づける - 自分で必要な
Importsだけを追加する運用に揃えられる
設定をオフにしても直らない場合のチェックリスト
一部の環境では、オプションをオフにして再起動してもImportsが追加され続けるという報告があります。たとえば Visual Studio Community 2022 (64-bit) Version 17.13.2 で同様の現象があった、という声が出ています。こうした場合は「設定が反映されていない」のか「別要因で追加されている」のかを切り分けるのが近道です。
まずはここを確認（早く効く順）
| 確認ポイント | 見方 | 対処 |
|---|---|---|
| 本当にVB用の設定を変えたか | C#側の設定を触っていないか | Visual Basic配下の項目であることを再確認 |
| 再起動で反映されているか | 設定変更後すぐは残ることがある | Visual Studioを一度終了して起動し直す |
| 貼り付け方法が特殊でないか | 拡張機能のPaste機能やテンプレート挿入 | 通常のCtrl+Vで再現するか確認 |
| 同じコードで毎回再現するか | 特定の型名・記法でだけ起きる可能性 | 最小再現コードを作って原因を絞る |
拡張機能の影響を切り分ける
コード補完、リファクタリング、静的解析などの拡張機能が、独自にImportsを補完しているケースもあります。チーム開発で「自分だけ挙動が違う」場合は特に疑う価値があります。
- 拡張機能を一時的に無効化し、貼り付けの挙動を確認する
- 可能であれば、Visual Studioをセーフモード（拡張機能なし）で起動して再現するか確認する
- 会社PCなどでポリシー配布の拡張機能が入っている場合は、管理者に確認する
切り分けができたら、原因の拡張機能だけ設定を見直す、または更新・置き換えを検討します。
設定の破損・反映不良を疑う
Visual Studioの設定が何らかの理由で反映されていない場合、次の手順が有効なことがあります（手戻りを減らすため、上から順に試すのがおすすめです）。
- Visual Studioを最新へ更新：既知の不具合が修正されている可能性があります。
- 設定のエクスポート：現状の設定をバックアップし、問題が起きても戻せるようにします。
- 設定のリセット：環境を初期状態へ戻して再現するか確認します（戻しはバックアップから）。
- Visual Studioの修復（Repair）：インストールの不整合がある場合に改善することがあります。
不具合報告をするなら（再現性を高めるコツ）
「設定どおりに動かない」可能性があるなら、Microsoft Developer Communityなどへ報告すると今後の修正につながります。報告時は次の情報があると、調査してもらいやすくなります。
- Visual Studioのエディション／バージョン（例：17.13.2など）
- 対象言語（VB）とプロジェクト種別（.NET Framework / .NET など）
- 貼り付け元と貼り付け先のプロジェクト参照の違い（NuGet、参照アセンブリ）
- 最小の再現コード（数十行程度）と、期待する挙動／実際の挙動
- 導入している拡張機能一覧（可能ならセーフモードでも再現するか）
実務向け：Imports運用を安定させるコツ
「貼り付け時に増えない」だけでなく、長期的にImportsが破綻しない運用も大切です。ここでは、トラブルになりにくい実践ポイントをまとめます。
貼り付け前に“参照”を揃える（Importsより先に重要）
Importsは名前空間を短く書くための仕組みであり、参照（アセンブリやNuGetパッケージ）が不足していると、Importsを足してもビルドは通りません。別プロジェクトへ移植する場合、先に次を確認すると作業がスムーズです。
| 確認項目 | 例 | 不足するとどうなるか |
|---|---|---|
| NuGetパッケージ | JSON/HTTP/DIなど外部ライブラリ | 型が見つからずエラーになる |
| プロジェクト参照 | 共通DLL、社内ライブラリ | 名前空間も型も解決できない |
| ターゲットフレームワーク | .NET Framework と .NET の差 | APIが存在せず置き換えが必要 |
“未使用Imports”の掃除を素早くする
貼り付け時の自動追加を止めても、開発中に試行錯誤すれば未使用のImportsはどうしても発生します。そこで、次のような「掃除手段」を決めておくと、チーム全体のノイズが減ります。
- エディターのクイックアクション（電球アイコン）で「未使用の
Importsを削除」「並び替え」を実行する - コードクリーンアップ（整形・整理）を、保存時やコミット前のタイミングに合わせて実行する
- 静的解析やフォーマッターのルールで、未使用
Importsを警告として拾う
ポイントは、貼り付けの瞬間に自動で増やすのではなく、必要なタイミングで整理することです。これなら「勝手に変わった」感が減り、差分の意図も説明しやすくなります。
プロジェクト単位の既定Importsを理解する
VBには、ファイルごとのImportsとは別に、プロジェクト全体に適用される既定のインポート（既定で参照される名前空間）があります。プロジェクトのプロパティで管理でき、全ファイルに共通で使う名前空間をここへ寄せると、各ファイルの先頭がすっきりします。
ただし、既定Importsを増やしすぎると「どこから型が来ているのか」が見えづらくなるため、次の基準で判断するのが安全です。
- ほぼ全ファイルで使うものだけを既定化する（例：基本的な名前空間）
- 機能別のライブラリ（例：特定の業務ドメイン）まで既定化しない
- チームの規約として、既定化する一覧をドキュメント化する
よくある質問
貼り付け時にImportsが追加されるのはバグですか？
多くの場合は仕様（補助機能）です。貼り付けたコードがすぐに解決できるように、Visual Studioが不足分を推測して補うためです。ただし、設定をオフにしても止まらない場合は、拡張機能やバージョン固有の不具合の可能性があります。
不要なImportsが増えても動作に影響はありますか？
ビルドの成否だけで見ると影響がないケースもありますが、実務では「差分ノイズ」「レビュー負荷」「名前衝突」「意図しない依存の温床」など、じわじわ効いてきます。規模が大きいほど、先に抑えておく価値があります。
チーム全員に同じ挙動を徹底したいです
この設定は基本的にIDE側の環境設定のため、プロジェクトを開いたら自動的に統一されるタイプではありません。チーム規約として「Add missing imports on pasteはオフ」を明記し、必要に応じて設定のエクスポート／インポートで合わせる運用が現実的です。
貼り付け後に必要なImportsだけ素早く追加したい
自動追加をオフにすると、必要な型が解決できない箇所がエディター上でエラーになります。その状態でクイックアクション（電球）を使うと、候補のImportsを選んで追加できることが多いです。結果として「自分で選んだものだけが入る」ため、過剰な追加を避けやすくなります。
まとめ：まずは“貼り付け時の自動追加”を止めて、必要なときに整理する
VBのモジュールを別プロジェクトへ移植するとき、貼り付け時にImportsが大量に追加されるのは、Visual Studioの補助機能が原因です。オプションの Add missing imports on paste をオフにすることで、勝手な自動追加を止め、足りないものはコンパイルエラーで検出する運用に戻せます。もし設定が効かない場合は、バージョン更新・拡張機能の切り分け・設定リセット／修復まで含めて順に確認していきましょう。
コメント