變更組建輸出目錄

您可以根據組態 (針對偵錯及/或版本) 指定專案所產生的輸出位置。 使用預設設定時，輸出資料夾因專案類型和 SDK 而有所不同，有些專案使用特定平台或特定架構的子資料夾。

Visual Studio 提供屬性，可讓您藉由指定相對於專案資料夾的路徑，或檔案系統中任何位置的絕對路徑，將中繼和最終輸出置於自訂資料夾。 除了您在 Visual Studio 專案屬性中指定的設定之外，您也可以編輯專案檔，並使用 MSBuild 和 .NET SDK 的功能進一步自訂輸出，無論是針對個別專案，還是在許多專案的解決方案層級，皆完全控制專案輸出的所有層面。

在 Visual Studio 2022 中，視您的專案類型而定，有不同的專案設計工具使用者介面。 C# .NET Framework 和所有 Visual Basic 專案都會使用舊版 .NET 專案設計工具，但 C# .NET Core (和 .NET 5 和更新版本) 專案會使用目前的 .NET 專案設計工具。 C++ 專案會使用自己的屬性頁使用者介面。 本節中的步驟取決於您所使用的專案設計工具。

變更組建輸出目錄

C# .NET Core

此程序適用於 Visual Studio 2022 中以 .NET Core 或 .NET 5 和更新版本為目標的 C# 專案。

1. 清除專案或解決方案，移除任何現有的輸出檔案 (組建>清除解決方案)。

2. 在方案總管中以滑鼠右鍵按一下專案節點，並選取 [屬性]。

3. 展開建置區段，然後向下捲動至輸出子區段。

4. 尋找 C# 的 [基礎輸出路徑]，並鍵入要產生輸出的目標路徑 (絕對或相對於根專案目錄)，或改為選擇 [瀏覽] 以瀏覽至該資料夾。 請注意，設定名稱會附加至基礎輸出路徑，以產生實際的輸出路徑。

   

   注意

   某些專案 (.NET 和 ASP.NET Core) 預設會在最終輸出路徑包含架構版本或執行階段識別碼。 若要變更此設定，請在方案總管中以滑鼠右鍵按一專案節點，選取 [編輯專案檔]，然後新增下列項目：

   <PropertyGroup>
     <AppendTargetFrameworkToOutputPath>false</AppendTargetFrameworkToOutputPath>
     <AppendRuntimeIdentifierToOutputPath>false</AppendRuntimeIdentifierToOutputPath>
   </PropertyGroup>
   

建置通用輸出目錄

依預設，Visual Studio 會在方案內專屬資料夾的方案中建立每個專案。 您可以變更專案的建置輸出路徑，強制將所有輸出放在相同的資料夾中。

1. 清除解決方案，移除任何現有的輸出檔案 (組建>清除解決方案)。

2. 按一下方案中的一個專案。

3. 按一下 [專案] 功能表上的 [屬性]。

4. 在每個專案中，根據其類型，選取 [編譯] 或 [組建]，並將 [輸出路徑] 或 [基礎輸出路徑] 設定為要用於方案中所有專案的資料夾。

5. 開啟專案的專案檔，並將下列屬性宣告加入至第一個屬性群組。

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
   </PropertyGroup>
   

   將 UseCommonOutputDirectory 設定為 true 會告知 Visual Studio 及其基礎建置引擎 (MSBuild)，您要將多個專案輸出放在相同的資料夾中，因此 MSBuild 會省略專案相依於其他專案時通常發生的複製步驟。

6. 針對解決方案中的所有專案，重複步驟 2-5。 如果您有一些不應該使用通用輸出目錄的特殊專案，則可以略過某些專案。

提示

如果您指定的位置並未產生輸出，請確定您已正確選取 Visual Studio 的功能表列來建置對應組態 (例如 [偵錯] 或 [發行])。

VB 和 .NET Framework

此程序適用於 .NET Framework 專案和 Visual Basic 專案。

1. 清除專案或解決方案，移除任何現有的輸出檔案 (組建>清除解決方案)。

2. 在方案總管中以滑鼠右鍵按一下專案節點，並選取 [屬性]。

3. 根據您的專案類型，選取適當的索引標籤：

   • 若是 C#，請選取 [建置] 索引標籤。
   • 若是 Visual Basic，請選取 [編譯] 索引標籤。

4. 在頂端的組態下拉式清單中，選擇您想要變更其輸出檔位置的組態 ([偵錯]、[發行] 或 [所有組態])。

5. 在頁面中尋找輸出路徑項目，因您的專案類型而異：

   • 輸出路徑適用於 C++ 和 JavaScript 專案
   • 組建輸出路徑適用於 Visual Basic 專案

   鍵入要產生輸出的目標路徑 (絕對或相對於根專案目錄)，或改為選擇 [瀏覽] 以瀏覽至該資料夾。

   

建置通用輸出目錄

依預設，Visual Studio 會在方案內專屬資料夾的方案中建立每個專案。 您可以變更專案的建置輸出路徑，強制將所有輸出放在相同的資料夾中。

1. 清除解決方案，移除任何現有的輸出檔案 (組建>清除解決方案)。

2. 按一下方案中的一個專案。

3. 按一下 [專案] 功能表上的 [屬性]。

4. 在每個專案中，根據其類型，選取 [編譯] 或 [組建]，並將 [輸出路徑] 或 [基礎輸出路徑] 設定為要用於方案中所有專案的資料夾。

5. 開啟專案的專案檔，並將下列屬性宣告加入至第一個屬性群組。

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <UseCommonOutputDirectory>true</UseCommonOutputDirectory>
   </PropertyGroup>
   

   將 UseCommonOutputDirectory 設定為 true 會告知 Visual Studio 及其基礎建置引擎 (MSBuild)，您要將多個專案輸出放在相同的資料夾中，因此 MSBuild 會省略專案相依於其他專案時通常發生的複製步驟。

6. 針對解決方案中的所有專案，重複步驟 2-5。 如果您有一些不應該使用通用輸出目錄的特殊專案，則可以略過某些專案。

提示

如果您指定的位置並未產生輸出，請確定您已正確選取 Visual Studio 的功能表列來建置對應組態 (例如 [偵錯] 或 [發行])。

C++

若要變更單一 C++ 專案的組建輸出目錄：

1. 清除專案，移除任何現有的輸出檔案 (組建>清除解決方案)。

2. 在方案總管中以滑鼠右鍵按一下專案節點，並選取 [屬性]。

3. 選取一般索引標籤。

4. 在頂端的組態下拉式清單中，選擇您想要變更其輸出檔位置的組態 ([偵錯]、[發行] 或 [所有組態])。

   如果您正檢視[所有設定] 或[所有平台]，查看 <different options> 即可獲得部分屬性。 每個設定和平台組合的屬性值可能不同。 雖然您可以個別設定它們，但預設設定會針對所有組合使用相同的運算式，不過它們會使用巨集 $(Configuration) 和 $(Platform)，為每個組合產生唯一的輸出路徑。

5. 在[輸出] 目錄尋找輸出路徑。 下拉式清單提供編輯運算式或瀏覽至路徑的選項，或 (如果相關) <自父系或專案預設值繼承>。

   鍵入要產生輸出的目標路徑 (絕對或相對於根專案目錄)，或改為選擇 [瀏覽] 以瀏覽至該資料夾。

   

   針對相依於巨集值的運算式，按下[巨集 >>] 以檢視可用的巨集及其值。 對話方塊也會顯示屬性的最終展開值，以及目前的巨集值。

   所有環境變數都會在 MSBuild 中公開為屬性，因此如果您需要參考環境變數，您可以使用環境變數 VAR 的語法 $(VAR) 參考它。 使用巨集和環境變數建置路徑時，請斟酌是否需要反斜線。

此程序會在專案檔 (.vcxproj) 設定屬性 OutDir。 如果您在設定此屬性之後檢視專案檔，會看到新增了與下列相似的程式碼：

  <PropertyGroup Condition="'$(Configuration)|$(Platform)'=='Debug|x64'">
    <OutDir>C:\MyOutputFolder</OutDir>
  </PropertyGroup>

如需詳細資訊，請參閱[一般屬性頁]，若要確定您已熟悉如何使用 C++ 屬性頁，了解可如何根據組態和平台設定屬性值，請參閱使用專案屬性。

設定專案的中繼輸出目錄

C# .NET Core

此程序適用於 Visual Studio 2022 中以 .NET Core 或 .NET 5 和更新版本為目標的 C# 專案。

1. 清除專案，移除任何現有的輸出檔案。

2. 開啟專案檔案。

3. 將下列屬性宣告新增至第一個屬性群組。

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <IntermediateOutputPath>path</IntermediateOutputPath>
   </PropertyGroup>
   

   路徑會與專案檔相對，或者您可以使用絕對路徑。 如果您想要將專案名稱放在路徑中，您可以使用 MSBuild 屬性 $(MSBuildProjectName)、$(MSBuildProjectDirectory) 來參考它。 如需您可以使用的更多屬性，請參閱 MSBuild 保留和已知屬性。

4. 建置時，Visual Studio 仍然會在專案資料夾底下建立 obj 資料夾，但它是空的。 您可以隨著建置程序的一部分將它刪除。 執行該動作的其中一個方法，是新增建置後事件以執行下列命令：

   rd "$(ProjectDir)obj" /s /q
   

   請參閱指定自訂建置事件。

VB 和 .NET Framework

此程序適用於 .NET Framework 專案和 Visual Basic 專案。

1. 清除專案，移除任何現有的輸出檔案。

2. 開啟專案檔案。

3. 將下列屬性宣告新增至第一個屬性群組。

   <PropertyGroup>
     <!-- existing property declarations are here -->
     <IntermediateOutputPath>path</IntermediateOutputPath>
   </PropertyGroup>
   

   路徑會與專案檔相對，或者您可以使用絕對路徑。 如果您想要將專案名稱放在路徑中，您可以使用 MSBuild 屬性 $(MSBuildProjectName)、$(MSBuildProjectDirectory) 來參考它。 如需您可以使用的更多屬性，請參閱 MSBuild 保留和已知屬性。

4. 建置時，Visual Studio 仍然會在專案資料夾底下建立 obj 資料夾，但它是空的。 您可以隨著建置程序的一部分將它刪除。 執行該動作的其中一個方法，是新增建置後事件以執行下列命令：

   rd "$(ProjectDir)obj" /s /q
   

   請參閱指定自訂建置事件。

C++

使用 Intermediate Directory 屬性可設定中繼輸出的目錄，例如 .obj 檔案。

專案檔中的屬性為 IntDir。 若要在專案檔設定中繼和最終輸出的路徑，請新增屬性群組，如下所示：

  <PropertyGroup>
    <OutDir>$(SolutionDir)out\$(Platform)\$(Configuration)\</OutDir>
    <IntDir>$(SolutionDir)int\$(MSBuildProjectName)\$(Platform)\$(Configuration)\</IntDir>
  </PropertyGroup>

使用 Directory.Build.props 設定輸出目錄

C# .NET Core

如果您有大量專案，而且想要變更全部的輸出資料夾，則使用本文前述的方法逐一變更，可能繁瑣又容易出錯。 在這種情況，您可以在解決方案資料夾 Directory.Build.props 建立檔案，在一個地方設定適當的 MSBuild 屬性，套用至解決方案中的所有專案。 將具有此特定名稱的檔案放在您想要影響之所有專案的父資料夾，可以輕鬆地在單一位置維護自訂以及輕鬆變更數值。 請參閱依資料夾自訂組建。

VB 和 .NET Framework

如果您有大量專案，而且想要變更全部的輸出資料夾，則使用本文前述的方法逐一變更，可能繁瑣又容易出錯。 在這種情況，您可以在解決方案資料夾 Directory.Build.props 建立檔案，在一個地方設定適當的 MSBuild 屬性，套用至解決方案中的所有專案。 將具有此特定名稱的檔案放在您想要影響之所有專案的父資料夾，可以輕鬆地在單一位置維護自訂以及輕鬆變更數值。 請參閱依資料夾自訂組建。

C++

如果您有大量專案，而且想要變更全部的輸出資料夾，則使用本文前述的方法逐一變更，可能繁瑣又容易出錯。 在這種情況，您可以在解決方案資料夾 Directory.Build.props 建立檔案，在一個地方設定適當的 MSBuild 屬性，套用至解決方案中的所有專案。 將具有此特定名稱的檔案放在您想要影響之所有專案的父資料夾，可以輕鬆地在單一位置維護自訂以及輕鬆變更數值。 請參閱自訂 C++ 組建。

若要在 Directory.build.props 設定中繼和最終輸出路徑，最好使用 $(MSBuildThisFileDirectory) 而不要使用 $(SolutionDir)，以支援未定義 $(SolutionDir) 的命令列專案組建。 下列程式碼會以適用於 Visual Studio 組建和個別專案命令列組建的方式設定：

<Project>
<PropertyGroup>
    <SolutionDir Condition="'$(SolutionDir)' == ''">$(MSBuildThisFileDirectory)</SolutionDir>
    <OutDir>$(SolutionDir)out\$(Platform)\$(Configuration)\</OutDir>
    <IntDir>$(SolutionDir)int\$(MSBuildProjectName)\$(Platform)\$(Configuration)\</IntDir>
  </PropertyGroup>
</Project>

使用成品整理組建輸出

針對 .NET 8 專案，您可以使用成品功能，以高度自訂和彈性的方式安排輸出。 請參閱成品輸出配置。

相關內容

• 專案設計工具、建置頁面 (C#)
• 一般屬性頁面 (專案)
• 編譯及建置