Visual Studio のプロジェクト削除手順｜Remove との違いと .sln 編集

1Visual Studio プロジェクト削除の 3 つの選択肢

2標準手順: Solution Explorer から削除

1. Solution Explorer でプロジェクトを右クリック
2. Remove（ソリューションから外す） or Delete（完全削除）を選択
   • Remove のショートカット: Delete キー
   • Delete のショートカット: Shift + Delete
3. 確認ダイアログで OK

Remove と Delete の違い:

Solution: MyApp.sln
├── ProjectA (削除したい)        ← .sln から行を消す + 物理ファイルどうするか
├── ProjectB
└── ProjectC

Remove:
  - .sln から ProjectA の行を削除
  - C:\src\MyApp\ProjectA\ フォルダはそのまま残る
  - 別ソリューションで再利用可能

Delete:
  - .sln から ProjectA の行を削除
  - C:\src\MyApp\ProjectA\ フォルダをごみ箱へ
  - 復元はごみ箱から

3削除前にやるべき: 参照クリーンアップ

プロジェクト B が プロジェクト A を参照していたら、A を消すと B がビルドエラーになります。先に参照を外しておきます。

1. Solution Explorer でプロジェクト B を展開
2. References / Dependencies を展開
3. ProjectA への参照を右クリック → Remove
4. 必要なら ProjectA の機能をローカルコピーしておく
5. その後 ProjectA を削除

4VS を閉じてエクスプローラから完全削除

# 1) Visual Studio を完全終了
Get-Process devenv -ErrorAction SilentlyContinue | Stop-Process -Force

# 2) プロジェクトフォルダを削除
$proj = 'C:\src\MyApp\ProjectA'
Remove-Item $proj -Recurse -Force

# 3) .sln から該当行を削除（テキストエディタで開く）
# Project("{FAE04EC0-301F-11D3-BF4B-00C04F79EFBC}") = "ProjectA", "ProjectA\ProjectA.csproj", "{...}"
# EndProject
# この 2 行を削除

# Global セクションの GUID 参照も削除
# Project("{...}").Debug|Any CPU.ActiveCfg = ...
# Project("{...}").Debug|Any CPU.Build.0 = ...
# (該当 GUID の行をすべて削除)

# 4) IDE キャッシュもクリア
Remove-Item C:\src\MyApp\.vs -Recurse -Force -ErrorAction SilentlyContinue

5.sln ファイルの構造（手動編集用）

Microsoft Visual Studio Solution File, Format Version 12.00
# Visual Studio Version 17
VisualStudioVersion = 17.0.31903.59
MinimumVisualStudioVersion = 10.0.40219.1

Project("{FAE04EC0-...}") = "ProjectA", "ProjectA\ProjectA.csproj", "{AAA-GUID-AAA}"
EndProject
Project("{FAE04EC0-...}") = "ProjectB", "ProjectB\ProjectB.csproj", "{BBB-GUID-BBB}"
EndProject

Global
    GlobalSection(SolutionConfigurationPlatforms) = preSolution
        Debug|Any CPU = Debug|Any CPU
        Release|Any CPU = Release|Any CPU
    EndGlobalSection
    GlobalSection(ProjectConfigurationPlatforms) = postSolution
        {AAA-GUID-AAA}.Debug|Any CPU.ActiveCfg = Debug|Any CPU    ← ProjectA 削除時はこの行も消す
        {AAA-GUID-AAA}.Debug|Any CPU.Build.0 = Debug|Any CPU
        {BBB-GUID-BBB}.Debug|Any CPU.ActiveCfg = Debug|Any CPU
    EndGlobalSection
EndGlobal

6Git 管理下のプロジェクト削除

# Visual Studio から Delete した後でも Git は変更を追跡する
git status
# deleted: ProjectA/...
# modified: MyApp.sln

# まとめてコミット
git add -A
git commit -m "Remove ProjectA from solution"

# 別解: git rm でフォルダごと削除（VS Delete を介さず）
git rm -r ProjectA/
# .sln は手動で編集してからコミット

# 履歴から完全に消したい場合（重要: 公開リポでは要相談）
git filter-repo --path ProjectA --invert-paths
# または BFG Repo-Cleaner
java -jar bfg.jar --delete-folders ProjectA
git push --force-with-lease

7削除したのに残るパターン

8FAQ

Q: Unload Project と Remove の違い
A: Unload は一時的に読み込まない（ファイルは残るし .sln 内の参照も残る）。Remove は .sln から完全に外す。デバッグや一時的なビルド時短に Unload を使う。

Q: 削除後にビルドが通らない
A: 他プロジェクトの References に残骸あり。dotnet build -v normal でエラー詳細を確認 → 参照削除 → dotnet restore。

Q: フォルダだけ消した後、復元したい
A: ごみ箱にあれば戻す。Git 管理下なら git checkout HEAD -- ProjectA。