如何将本地Git仓库（含完整历史）迁移至TFS（Visual Studio操作）

数据老陈

2026-5-27

Alright, let's break down exactly how to move your local Git repo (with all its commit history) over to your existing TFS project using Visual Studio—without touching your local history at all. Here's a straightforward, step-by-step guide tailored to your needs:

Step 1: Connect Visual Studio to Your TFS Project

Fire up Visual Studio and open the Team Explorer tab (if it’s not visible, use View > Team Explorer to bring it up).
Click Connect to Project, then select your existing TFS project from the list. If it doesn’t show up, add your TFS server URL and authenticate with your credentials.

Step 2: Add TFS as a Remote to Your Local Git Repo

In Team Explorer, navigate to the Changes section, click the gear icon (Settings) and select Repository Settings.
Under the Remotes section, click Add.
Name the remote something clear like tfs-origin (this avoids confusion with any existing origin remote you might have), then paste the clone URL of your TFS repo. You can grab this URL from your TFS project’s repo page by clicking the Clone button.

Step 3: Push All Branches and Full Commit History to TFS

Head to the Branches section in Team Explorer.
For each branch you want to migrate (like main, feature branches, etc.), right-click the branch and select Push, making sure to choose the tfs-origin remote you just added.
If you’ve got a bunch of branches, using Visual Studio’s integrated terminal is faster—run this command to push all branches and their history in one go:
```
git push --all tfs-origin
```
If you have tags you want to bring over too, run this extra command:
```
git push --tags tfs-origin
```

Step 4: Double-Check the Migration in TFS

Jump over to your TFS project’s repo page. Verify that all your branches are present, and click into the commit history to confirm every local commit (messages, timestamps, authors) is there exactly as it was on your machine.

Step 5: Switch Your Local Repo to Default to TFS (Optional but Recommended)

To make future development flow smoothly with TFS, you can set tfs-origin as the upstream remote for your working branch. For example, for the main branch:
```
git branch --set-upstream-to=tfs-origin/main main
```
Or, if you want to keep the standard origin name for TFS, rename your old remote (if any) and rebrand the TFS remote:
```
git remote rename origin old-origin
git remote rename tfs-origin origin
```

Key Things to Remember

Your local Git repo’s history stays 100% intact throughout this process—we’re just copying the history to TFS, not modifying anything on your local machine.
If you hit push errors (like permission issues), double-check your TFS credentials in Visual Studio and make sure you have write access to the TFS repo.
Once you’ve confirmed everything is in TFS, you can start developing directly against the TFS repo moving forward—your local repo will now sync with TFS instead of whatever remote you used before.

内容的提问来源于stack exchange，提问作者Abdullah