Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022
Visual Studio 2019 |Visual Studio 2022
當您使用 Visual Studio 方案總管 ，且您的專案處於版本控制之下時，通常會自動將檔案新增至版本控制。 但是，在某些情況下，您必須採取額外的步驟才能將檔案和專案新增至版本控制。
先決條件
| 類別 | 需求 |
|---|---|
| 許可 | 您專案的 參與者 群組成員。 |
如需詳細資訊，請參閱 預設 TFVC 許可權。
這很重要
這些程序僅適用於您使用 本機工作區時。 當您使用本機工作區時，系統會自動將新檔案偵測為擱置中的變更。 相反地，您儲存在伺服器工作區中的檔案會新增並簽入，而不會顯示為擱置的變更。
在版本控制下建立新的程式碼專案和解決方案
您可以建立新的 Visual Studio 專案，並將它新增至版本控制，讓您和您的小組可以立即享受版本控制的所有優點，從您撰寫的第一行程式碼開始。
在 Visual Studio 中， 連線到您的 Azure DevOps 專案。
選取 [ 檔案>] [新增專案]，或按 Ctrl+Shift+N。
在 建立新專案 畫面上，選取您要建立的程式碼專案類型，然後選取 下一步。
![[建立新專案] 對話方塊的螢幕擷取畫面。](media/add-files-server/create-project.png?view=azure-devops-server)
在 設定您的新專案 畫面的 專案名稱下，輸入專案的名稱。
在 [位置] 底下，指定 本機工作資料夾的路徑，例如 c：\code\SiteApp\Main\，在 您設定開發機器時建立的工作區中。
讓其餘設定保持原樣，然後選取 下一步。
在 [其他資訊] 畫面上，視需要變更任何設定，然後選取 [建立]。
建立專案之後，請在 [方案總管] 中檢視它，您可以按 Ctrl+Alt+L 來開啟。
以滑鼠右鍵按一下 [方案總管] 中的解決方案名稱，然後從操作功能表中選取 [將解決方案新增至原始檔控制 ]。
切換至 [小組總管 ] 視窗，然後選取 [ 簽入] 以 將專案簽入原始檔控制。
將現有的解決方案和程式碼專案置於版本控制之下
若要將現有的解決方案新增至版本控制，請將所有解決方案檔案移至您的工作區，然後在 Visual Studio 中新增它們。
在 Visual Studio 中， 連線到您的 Azure DevOps 專案。
選擇 [檢視>其他 Windows>原始檔控制總管]。
在 原始檔控制總管中，流覽至解決方案的邏輯父資料夾，例如 $/SiteApp/Main，其中 SiteApp 是專案的名稱。 若要深入瞭解如何命名本機資料夾，請參閱最佳 化資料夾名稱。
選取視窗頂端的 連結，以 在 Windows 檔案總管中開啟父資料夾。 如果連結顯示 未對應，請參閱 建立和使用工作區， 以取得對應工作區的相關資訊。
在 [檔案總管] 中，將包含解決方案的資料夾移至父資料夾。
在 Visual Studio 中，選擇 [ 檔案>] [開啟專案]，然後流覽至並開啟解決方案。
在 [方案總管] 中，以滑鼠右鍵按一下解決方案名稱，然後從操作功能表中選取 [ 將解決方案新增至原始檔控制 ]。
再次以滑鼠右鍵按一下解決方案名稱，然後從操作功能表中選取 [ 簽入 ]。
在 Team Explorer 的 [擱置變更] 頁面上，如果您在 [排除的變更] 區段中看到 [偵測到的] 連結，請選取連結。
[ 升級候選變更 ] 對話方塊會列出解決方案中任何程式碼專案未參考的檔案。 選取您要簽入的任何檔案，取消選取任何您不想簽入的檔案，然後選取 [升級] ，將選取的檔案移至 [包含的變更]。 如果您不想簽入任何列出的檔案，請選取 [取消] 以關閉對話方塊。
選取 [簽入]。
如需詳細資訊，請參閱 提交待處理的變更。
將一或多個檔案新增至版本控制
當您在 Visual Studio 方案總管中將檔案新增至程式碼專案時，系統會自動將檔案新增至版本控制。 您也可以新增程式碼專案未參考的檔案。
自動將一或多個檔案新增至版本控制
在 Visual Studio 中， 連線到您的 Azure DevOps 專案。
選擇 [檢視>其他 Windows>原始檔控制總管]。
在 原始檔控制總管中，導覽至您要新增檔案或資料夾的資料夾。
選取 [原始檔控制總管] 視窗頂端的 [本機路徑] 旁的連結，以在 Windows 檔案總管中開啟目標資料夾。 如果連結顯示 未對應，請參閱 建立和使用工作區， 並對應您的工作區。
在檔案總管中，將檔案或資料夾移至目標資料夾。
在 Visual Studio 小組總管的 [擱置變更] 頁面上，如果您在 [排除的變更] 底下看到 [偵測到] 連結，請選取連結。
在 [升級候選變更 ] 對話方塊中，只選取您要簽入的檔案，然後選取 [ 升級]。 如果您不想簽入任何列出的檔案，請選取 [取消 ]。
選取 [簽入]。
如需詳細資訊，請參閱 提交待處理的變更。
手動將檔案新增至版本控制
您也可以手動將檔案新增至版本控制。
在 Visual Studio 中，選擇 [ 檢視>其他 Windows>原始檔控制總管]。
在 原始檔控制總管中，導覽至您要新增檔案的資料夾。
這很重要
請確定此資料夾已簽入。 如果您建立新資料夾，請以滑鼠右鍵按一下該資料夾並選擇 「簽入」，然後簽入新資料夾，然後再繼續。
將檔案從 Windows 檔案總管拖曳至 Visual Studio 原始檔控制總管 視窗。
在 [小組總管] 的 [擱置變更] 頁面上，確定 [包含的專案] 會列出您要新增的所有檔案，然後選取 [簽入]。
使用程式碼未包含的二進位檔
許多團隊依賴其程式碼解決方案之外存在的二進位檔。 通常，這些二進位檔是團隊從第三方授權的程式庫的一部分，或者二進位檔來自同一公司的另一個團隊。 例如，團隊 A 相依於團隊 B 所產生的二進位檔，而每個團隊都在不同的專案集合中工作。 B 團隊將二進位檔交付給 A 團隊，然後團隊 A 將它們簽入版本控制。
小提示
NuGet 套件可讓您的小組更輕鬆地管理相依性，並讓二進位檔保持最新狀態。 您可以使用 Azure Artifacts 將 NuGet 套件儲存在 Azure DevOps Server 或 Azure DevOps Services 中。
您應該用來儲存外部二進位檔的資料夾和工作區結構，取決於您的解決方案相依於這些程式庫的方式。
在資料夾或分支結構中新增二進位檔
如果您將外部二進位檔放在包含解決方案資料夾的相同父資料夾中，則所有解決方案中的所有程式碼專案都可以參考具有相同相對路徑的程式庫。 例如，團隊可以使用下列資料夾結構：
然後，每個程式碼專案都可以使用相對路徑 ../../Lib來參考程式庫資料夾。
如果您的小組需要隔離需要不同版本二進位檔的個別工作，您可以將程式庫資料夾與解決方案資料夾一起分支。 例如，應用程式的第 1 版會利用程式庫的第 1 版。 當一些開發人員開發下一個版本時，他們使用版本 2，但其他開發人員尚未準備好升級。 您可以使用分支來管理這些狀況。
![顯示分支結構內 [文件庫] 資料夾的圖表。](media/add-files-server/ic581098.png?view=azure-devops-server)
使用工作區來對應二進位檔
有些公司必須管理對外部程式庫的更複雜的依賴關係。 例如，多個專案可能包含對一組通用程式庫具有不同相依性的解決方案。 在這些情況下，您可以將外部程式庫儲存在專用專案中。 各種專案的參與者會對應在包含所需程式庫的資料夾中。
例如，FabrikamFiber 會將下列專案、分支和資料夾結構置於適當的位置：
開發人員可以設定具有兩個工作區的開發機器，以進行兩種不同的工作，每個工作區都會對應在所需的程式庫中：
自訂版本控制會忽略哪些檔案
根據預設，版本控制會忽略特定類型的檔案，例如 .dll 檔案。 當您將忽略的檔案新增至本機工作區中對應的資料夾，或將忽略的檔案拖曳至 [原始檔控制總管] 時，檔案會出現在 [小組總管] 中 [擱置的變更] 頁面上的 [排除的專案] 底下。
您可以將 .tfignore 文字檔放在要套用設定的資料夾中，以設定要忽略的檔案類型。 .tfignore 檔案效果是遞迴的，但子資料夾中的 .tfignore 檔案會覆寫父資料夾中的 .tfignore 檔案。
.tfignore 檔案的規則
下列規則適用於 .tfignore 檔案：
-
#開始評論行。 -
*並?支援萬用字元。 - 檔案規格是遞迴的，除非字元前
\置詞。 -
!否定檔案規格，因此不會忽略符合模式的檔案。
範例 .tfignore 檔案
######################################
# Ignore .cpp files in the ProjA subfolder and all its subfolders
ProjA\*.cpp
#
# Ignore .txt files in this folder
\*.txt
#
# Ignore .xml files in this folder and all its sub-folders
*.xml
#
# Ignore all files in the Temp sub-folder
\Temp
#
# Don't ignore .dll files in this folder nor in any of its subfolders
!*.dll
建立並使用 .tfignore 檔案
您可以手動建立使用上述規則的 .tfignore 文字檔，也可以在 [擱置的變更] 頁面偵測到排除的變更時自動產生 .tfignore 檔案。
- 在 [小組總管] 的 [擱置變更] 頁面上，選取 [排除的變更] 區段中的 [偵測到的] 連結。
- 在 「升級候選變更 」對話方塊中，以滑鼠右鍵按一下您要忽略的檔案，然後從操作功能表中選取「 忽略此本機項目」、「 依副檔名忽略」、「 依檔案名稱忽略」或「 依資料夾忽略 」。
- 選取 [取消] 以關閉對話方塊。
- .tfignore 檔案會出現在「擱置的變更」頁面的「包含的變更」區段中。 您可以開啟此檔案並對其進行修改以滿足您的需求。
.tfignore 檔案會新增為包含的擱置變更，因此您建立的規則會自動套用給取得檔案的人員。
從命令提示字元工作
針對自動化程式，或如果您想要使用命令提示字元，您可以使用 tf.exe 新增命令 ，而不是本文中的程式。 此 add 指令會將檔案從本機電腦上的工作區上傳至伺服器。