開始使用 Azure Repos 中的 Git

Azure DevOps 服務 |Azure DevOps Server |Azure DevOps Server 2022 |Azure DevOps Server 2020

Visual Studio 2019 |Visual Studio 2022

開始使用 Azure Repos 和 Git 存放庫來開發程式代碼。 您可以使用 Visual Studio 或 Git 命令來複寫存放庫、定義本機分支、提交和推送變更，以及與其他人同步處理。 如果您需要建立或匯入存放庫，請參閱 在專案中 建立新的 Git 存放庫或 匯入 Git 存放庫。

注意

本文說明如何使用 Visual Studio 來管理 Azure Repos Git 存放庫。 使用類似的程式，您可以使用 Visual Studio 來管理 GitHub 存放庫。 若要複製 GitHub 存放庫，請依照複製存放庫中的描述取得 URL。

如需 Git 工作流程的概觀，請參閱 Azure Repos Git 教學課程。

注意

Visual Studio 2019 第 16.8 版及後續版本提供 Git 功能選單，讓使用者比 Team Explorer 更少地進行內容切換來管理 Git 工作流程。 本文中的程式位於 Visual Studio 索引標籤底下，說明如何使用 Git 體驗，以及 Team Explorer。 如需詳細資訊，請參閱 Git 和 Team Explorer 的並存比較。

必要條件

類別	需求
專案存取	專案的成員。
許可	- 在私人項目中檢視程式碼：至少 基本 權限。 - 複製或貢獻私人專案中的程式碼：作為 貢獻者 安全群組的成員或在專案中具有相應的許可權。 - 設定分支或存放庫許可權：管理分支或存放庫的許可權 許可權。 - 變更預設分支：編輯原則 存放庫的許可權。 - 匯入存放庫：專案管理員成員 安全組或 Git 專案層級 建立存放庫 許可權設定為 允許。 如需詳細資訊，請參閱 設定 Git 存放庫許可權。
服務	啟用 Repos。
工具	選擇性。 使用 az repos 命令：Azure DevOps CLI。

注意

在公用專案中，具有 項目關係人 存取權的使用者具有 Azure Repos 的完整存取權，包括檢視、複製及參與程式代碼。

如需許可權和存取的詳細資訊，請參閱 預設 Git 存放庫和分支許可權 和 關於存取層級。

取得您的程序代碼

您可以 複製 遠端 Git 存放庫，以建立其本機複本。 複製會建立原始程式碼的複本，讓您能夠使用 和版本控制資訊，讓 Git 可以管理原始程式碼。

如果您想要建立本機存放庫而不複製，請參閱 建立新的 Git 存放庫。 建立本機存放庫之後，您可以繼續 提交、分享 和 同步 處理您的工作。

Visual Studio 2022

Visual Studio 2022 提供 Git 版本控制體驗，方法是使用 Git 功能表、Git 變更，以及透過 方案總管 中的操作功能表。 Visual Studio 2019 16.8 版也提供 Team Explorer Git 使用者介面。 如需詳細資訊，請參閱 Visual Studio 2019 - Team Explorer 索引標籤。

1. 在功能表列中的 [Git] 選單，選擇 [克隆存放庫...]

   

2. 在 [ 複製存放庫 ] 視窗中，輸入遠端存放庫位置和複製存放庫的資料夾路徑。 如果您不知道遠端存放庫位置，請從 [流覽存放庫] 選項中選取 [Azure DevOps]。

   

3. 選取 [克隆]。 複製 Git 存放庫之後，Visual Studio 會偵測存放庫，並將它新增至 Git 功能表中的 [本機存放庫] 清單。

   

注意

使用 Azure DevOps Services 時，專案 URL 的格式為 dev.azure.com/{your organization}/{your project}。 不過，先前格式仍然支援參考 visualstudio.com 格式。 如需詳細資訊，請參閱 Azure DevOps 簡介，將現有組織切換為使用新的網域名稱 URL。

Visual Studio 2019 - Git 功能表

Visual Studio 2019 提供 Git 版本控制體驗，方法是使用 Git 功能表、Git 變更，以及透過 方案總管 中的操作功能表。

1. 在功能表列中的 [Git] 選單，選擇 [克隆存放庫...]

   

2. 在 [ 複製存放庫 ] 視窗中，輸入遠端存放庫位置和複製存放庫的資料夾路徑。 如果您不知道遠端存放庫位置，請從 [流覽存放庫] 選項中選取 [Azure DevOps]。

   

3. 選取 [克隆]。 複製 Git 存放庫之後，Visual Studio 會偵測存放庫，並將它新增至 Git 功能表中的 [本機存放庫] 清單。

   

注意

使用 Azure DevOps Services 時，專案 URL 的格式為 dev.azure.com/{your organization}/{your project}。 不過，先前格式仍然支援參考 visualstudio.com 格式。 如需詳細資訊，請參閱 Azure DevOps 簡介，將現有組織切換為使用新的網域名稱 URL。

Visual Studio 2019 - 團隊資源管理器

Visual Studio 2019 16.8 版和更新版本提供 Git 版本控制體驗，同時維護 Team Explorer Git 使用者介面。 您可以從任一個介面交替使用 Git 功能。

注意

透過 Team Explorer 連線到專案的優點之一，就是您可以存取工作項目中樞。 如需Team Explorer功能的概觀，請參閱在Visual Studio Team Explorer 中巡覽。

1. 在 Team Explorer 中，選取 [連線] 以開啟 [連線] 頁面，然後選擇 [管理連線>連線至專案]。

   

2. 在 [ 連接到專案 ] 視窗中，選擇您要複製的存放庫，然後選取 [ 複製]。 如果您沒有看到存放庫，請選取 [新增 Azure DevOps Server ] 以新增裝載存放庫的伺服器。 您可以篩選清單以尋找存放庫。

   

3. 確認計算機上複製存放庫的位置，然後選取 [ 複製]。

注意

使用 Azure DevOps Services 時，專案 URL 的格式為 dev.azure.com/{your organization}/{your project}。 不過，先前格式仍然支援參考 visualstudio.com 格式。 如需詳細資訊，請參閱 Azure DevOps 簡介，將現有組織切換為使用新的網域名稱 URL。

Git 命令行

1. 下載並安裝適用於您平臺的 Git 和 Git 認證管理員。

2. 在瀏覽器中，移至 https://<your account name>.visualstudio.com 以開啟 Azure DevOps Services 網頁入口。

3. 流覽至 https://<your account name>.visualstudio.com 並尋找您的 Git 存放庫，在瀏覽器中開啟 Azure DevOps Services 入口網站。 從複製彈出視窗複製克隆 URL。

   

   注意

   使用 Azure DevOps Services 時，專案 URL 的格式為 dev.azure.com/{your organization}/{your project}。 不過，先前格式仍然支援參考 visualstudio.com 格式。 如需詳細資訊，請參閱 Azure DevOps 簡介，將現有組織切換為使用新的網域名稱 URL。

4. 在命令提示字元中，移至您要將程式代碼儲存在本機電腦上的資料夾。

5. 從命令提示字元中，執行 git clone ，後面接著複製URL，如下列範例所示。

    > git clone https://dev.azure.com/fabrikam-fiber/_git/FabrikamFiber
   

   Git 會為您下載程式碼並在新的資料夾中建立您自己的複本。

提交您的工作

Git 分支 會將您的變更與專案中的其他工作隔離。 建議的 Git 工作流程 是為您處理的每個功能或修正建立一個新的分支。 您會在本機 Git 存放庫中進行 提交，以在該分支上儲存變更。

Visual Studio 2022

1. 從功能表列的 [Git] 選單中，選擇 [新增分支...] 以開啟 [建立新的分支] 視窗。

   

2. 在 [ 建立新的分支 ] 視窗中，輸入描述性分支名稱，讓其他人知道分支包含的工作。 根據預設，Visual Studio 會從最新分支建立新的分支。 簽出分支核取方塊會自動將您切換至新建立的分支。 選取 建立。

   

3. 將 README.md 檔案新增至您複製的存放庫。 在 方案總管 中，您可以使用資料夾檢視瀏覽存放庫內容，或在存放庫中開啟Visual Studio解決方案。 Git 會追蹤 Visual Studio 內外所做的變更。

4. 當您對變更感到滿意時，請使用提交將它們儲存在 Git 中。 在 [ Git 變更 ] 視窗中，輸入描述變更的訊息，然後選取 [ 提交全部]。 認可所有 未標記的變更，並略過預備區域。 您可以選擇在認可之前暫存所有檔案，方法是在 [Git 變更] 視窗的 [變更] 區段頂端選取 [全部暫存 + (加號) 按鈕]。

   

   選取提交資訊連結，以獲取更多詳細資料。

   

注意

如果您有多個檔案，而且不想全部認可，您可以以滑鼠右鍵點擊每個檔案，然後選擇暫存。 當您暫存所有想要提交的檔案時，選取 提交暫存。 當您手動暫存變更時，暫存提交 會替換 全部提交。

Visual Studio 2019 - Git 功能表

1. 從功能表列的 [Git] 選單中，選擇 [新增分支...] 以開啟 [建立新的分支] 視窗。

   

2. 在 [ 建立新的分支 ] 視窗中，輸入描述性分支名稱，讓其他人知道分支包含的工作。 根據預設，Visual Studio 會從最新分支建立新的分支。 簽出分支核取方塊會自動將您切換至新建立的分支。 選取 建立。

   

3. 將 README.md 檔案新增至您複製的存放庫。 在 方案總管 中，您可以使用資料夾檢視瀏覽存放庫內容，或在存放庫中開啟Visual Studio解決方案。 Git 會追蹤 Visual Studio 內外所做的變更。

4. 當您對變更感到滿意時，請使用提交將它們儲存在 Git 中。 在 [ Git 變更 ] 視窗中，輸入描述變更的訊息，然後選取 [ 提交全部]。 認可所有 未標記的變更，並略過預備區域。 您可以選擇在認可之前暫存所有檔案，方法是在 [Git 變更] 視窗的 [變更] 區段頂端選取 [全部暫存 + (加號) 按鈕]。

   

   選取提交資訊連結，以獲取更多詳細資料。

   

注意

如果您有多個檔案，而且不想全部認可，您可以以滑鼠右鍵點擊每個檔案，然後選擇暫存。 當您暫存所有想要提交的檔案時，選取 提交暫存。 當您手動暫存變更時，暫存提交 會替換 全部提交。

Visual Studio 2019 - 團隊資源管理器

1. 在 [Team Explorer] 中，選取 [ 首頁 ] 按鈕，然後選擇 [ 分支]。

   

2. 以滑鼠右鍵按鍵按下預設分支，通常名為 main，然後選擇 [ 新增本機分支來源...

   

3. 輸入描述性分支名稱，讓其他人知道分支包含的工作。 選取 [ 建立分支]。

   

4. 將 README.md 檔案新增至您複製的存放庫。 從 Team Explorer 的 [首頁] 檢視中，您可以使用 [顯示資料夾檢視] 瀏覽存放庫內容，或在存放庫中開啟 Visual Studio 解決方案。 Git 會追蹤 Visual Studio 內外所做的變更。

5. 當您對變更感到滿意時，請使用提交將它們儲存在 Git 中。 選取 [首頁] 按鈕並選擇 [變更]，以開啟 Team Explorer 的 [變更] 檢視。

   

6. 輸入描述提交的訊息，然後選取 [全部提交]。

   

注意

如果您有多個檔案，而且不想全部認可，您可以以滑鼠右鍵點擊每個檔案，然後選擇暫存。 當您暫存所有想要提交的檔案時，選取 提交暫存。 當您手動暫存變更時，暫存提交 會替換 全部提交。

Git 命令行

1. 建立分支，您可以在其中變更程序代碼。 如果您要使用他們建立的分支來與某人共同作業，您可以跳到下列步驟 git checkout 。

    > git branch ReadMeFix
   

   為您的工作選擇一個具有描述性的分支名稱，以提醒您和其他人該分支所包含的工作內容。

2. 請查看您的分支，以便開始在分支中工作。

    > git checkout ReadMeFix
   

   您也可以使用 checkout 命令，開始在其他小組成員的工作分支上工作。

3. 在程式代碼上使用您慣用的工具進行變更。

4. 當您對變更感到滿意時，即使您尚未準備好發布這項工作，請使用提交將它們儲存在 Git 中。 除非您推送，否則不會共用您的修改，詳情請參閱下一節。

    > git commit -a -m "Descriptive message"
   

   此命令會將您的變更本地儲存至 Git 中的新 提交。 請務必在-m之後，提供一則描述您變更的簡短訊息給認可。

分享您的變更

在將一或多個提交新增至分支且準備好與其他人共用這些變更之後，推送您的提交，讓其他人可以看到這些變更。

推送提交之後，您可以建立 拉取請求。 提取要求可讓其他人知道您想要檢閱變更。 核准之後，提取要求通常會將您的變更新增至遠端存放庫的預設分支。

Visual Studio 2022

1. 在 [ Git 變更 ] 視窗中，選取向上鍵按鈕以推送您的認可。

   

   或者，您可以從 Git 存放庫視窗推送變更。 若要開啟 [Git 存放庫] 視窗，請在 [Git 變更] 視窗中選取傳出/傳入連結。

   

   或者，您可以從選單列的 Git 選單推送變更。

   

2. 建立提取要求，讓其他人可以檢閱您的變更。 如果您剛從 [Git 變更 ] 視窗推送變更，您可以選取 [建立提取要求 ] 連結，以開啟網頁瀏覽器，您可以在 Azure Repos 入口網站中建立新的提取要求。

   

   或者，如果您剛從 Git 存放庫 視窗推送變更，您可以選取 該視窗頂端的 [建立提取要求] 連結 。

   

   或者，您可以在 [Git 存放庫] 視窗中以滑鼠右鍵按兩下任何分支，然後選取 [建立提取要求]。

   

當提取要求在 Azure Repos 入口網站中開啟時，請確認您的來源和目的地分支。 在此範例中，我們想要將 add-readme-file 分支的提交合併至 main 分支。 輸入標題和選擇性描述、指定任何檢閱者、選擇性地關聯任何工作專案，然後選取 [ 建立]。

如需提取要求的詳細資訊，請參閱 提取要求 教學課程。

Visual Studio 2019 - Git 功能表

1. 在 [ Git 變更 ] 視窗中，選取向上鍵按鈕以推送您的認可。

   

   或者，您可以從 Git 存放庫視窗推送變更。 若要開啟 [Git 存放庫] 視窗，請在 [Git 變更] 視窗中選取傳出/傳入連結。

   

   或者，您可以從選單列的 Git 選單推送變更。

   

2. 建立提取要求，讓其他人可以檢閱您的變更。 如果您剛從 [Git 變更 ] 視窗推送變更，您可以選取 [建立提取要求 ] 連結，以開啟網頁瀏覽器，您可以在 Azure Repos 入口網站中建立新的提取要求。

   

   或者，如果您剛從 Git 存放庫 視窗推送變更，您可以選取 該視窗頂端的 [建立提取要求] 連結 。

   

   或者，您可以在 [Git 存放庫] 視窗中以滑鼠右鍵按兩下任何分支，然後選取 [建立提取要求]。

   

當提取要求在 Azure Repos 入口網站中開啟時，請確認您的來源和目的地分支。 在此範例中，我們想要將 add-readme-file 分支的提交合併至 main 分支。 輸入標題和選擇性描述、指定任何檢閱者、選擇性地關聯任何工作專案，然後選取 [ 建立]。

如需提取要求的詳細資訊，請參閱 提取要求 教學課程。

Visual Studio 2019 - 團隊資源管理器

1. 在 Team Explorer 中，選取 [ 首頁 ]，然後選擇 [ 同步 處理] 以開啟 [同步處理]。

   

   您也可以在提交後立即選擇[同步]，從[變更]移至[同步處理]檢視。

   

2. 在 [同步處理] 檢視中，選擇 [推送] 將提交上傳至遠端存放庫。 如果這是您第一次推送至存放庫，您會看到下列訊息： The current branch does not track a remote branch...，這可讓您知道您的認可已推送至遠端存放庫上的新分支，而且未來從最新分支推送的認可將會上傳至該遠端分支。

   

3. 建立提取要求，讓其他人可以檢閱您的變更。 在 Team Explorer 中，選擇 [首頁] 並打開 [拉取要求] 來查看[拉取要求]。

   

4. 在 拉取請求 中，您可檢視由您開啟、指派給您的拉取請求，並可建立新的拉取請求。 選取 [新增提取要求 ] 以開啟網頁瀏覽器，您可以在 Azure Repos 入口網站中建立新的提取要求。

   

當提取要求在 Azure Repos 入口網站中開啟時，請確認您的來源和目的地分支。 在此範例中，我們想要將 add-readme-file 分支的提交合併至 main 分支。 輸入標題和選擇性描述、指定任何檢閱者、選擇性地關聯任何工作專案，然後選取 [ 建立]。

如需提取要求的詳細資訊，請參閱 提取要求 教學課程。

Git 命令行

1. 推送您的分支，讓其他人可以看到您已儲存的變更。

    > git push -u origin ReadMeFix
   

2. 在網站入口中開啟專案，並瀏覽至 [程式碼] 標籤下的存放庫。選取 建立拉取請求 以為您推送的分支建立拉取請求。

   

3. 確認您的分支。 在此範例中，我們想將 ReadMeFix 分支的提交合併到 main 分支。 輸入標題和選擇性描述、指定任何檢閱者、選擇性地建立任何工作專案，然後選取 [ 建立]。

   

4. 一旦核准變更，請完成提取要求。 完整的拉取請求會將分支中的變更新增至程式碼的主分支。

   如需提取要求的詳細資訊，請參閱 提取要求 教學課程。

與其他人同步

您可以藉由 提取 其他人所建立的認可，讓本機分支與其遠端對應專案保持同步。 雖然 Git 擅長將傳入的變更與您的變更合併，但有時候您可能必須 解決合併衝突。 當您在功能分支上工作時，建議您定期切換到main分支，並從遠端main分支拉取新的提交，以保持其與遠端最新同步。

Visual Studio 2022

在 [Git 變更] 視窗中，您可以使用 [擷取]、[提取]、[推送] 和 [同步處理] 按鈕，讓本機分支保持與其遠端對應專案的最新狀態。

從上一個螢幕快照的左至右，按鈕控件如下：

• 擷取 會下載不在本機分支中的遠端提交，但不會合併它們。
• 拉取 會執行抓取，然後將下載的提交合併到您的本機分支。
• 推送會將未推送的提交 上傳至遠端存放庫，並將它們新增到對應的遠端分支。
• 同步會先執行提取，然後執行推送。

您也可以從 Git 功能表選取 [擷取]、[提取]、[推送] 和 [同步]。

Visual Studio 2019 - Git 功能表

在 [Git 變更] 視窗中，您可以使用 [擷取]、[提取]、[推送] 和 [同步處理] 按鈕，讓本機分支保持與其遠端對應專案的最新狀態。

從上一個螢幕快照的左至右，按鈕控件如下：

• 擷取 會下載不在本機分支中的遠端提交，但不會合併它們。
• 拉取 會執行抓取，然後將下載的提交合併到您的本機分支。
• 推送會將未推送的提交 上傳至遠端存放庫，並將它們新增到對應的遠端分支。
• 同步會先執行提取，然後執行推送。

您也可以從 Git 功能表選取 [擷取]、[提取]、[推送] 和 [同步]。

Visual Studio 2019 - 團隊資源管理器

1. 在 Team Explorer 中，選取 [ 首頁 ]，然後選擇 [同步 處理] 以開啟 [同步處理]。

   

2. 您可以使用拉取連結，將最新的變更下載至您的分支。 有兩個提取連結，一個靠近頂端，另一個在傳入認可區段中。 您可以使用任一項，因為它們都會執行相同的動作。

   

Git 命令行

1. 切換至您想要下載其他人所做的變更的分支。

    > git checkout ReadMeFix
   

   在此範例中，您會將小組上的其他人所做的變更提取到 ReadMeFix 分支的本機複本。

2. 將其他人的變更拉取到您的本地分支。

    > git pull
   

   Git 會下載變更，並將其與您自己的變更合併到您的本機分支。

相關文章

• Git 常見問題
• Visual Studio 中的 Git 體驗
• Git 和 Team Explorer 的並存比較