将本地托管的代码添加到 GitHub

关于将源代码导入 GitHub

将您的源代码导入 GitHub 使您和其他人更容易协同处理项目和管理代码。GitHub 可帮助您协作、跟踪更改和组织任务，从而简化项目构建和管理。有关更多信息，请参阅“关于 GitHub 和 Git”。

警告

切勿使用 `git add`、`commit` 或 `push` 命令将敏感信息（例如密码或 API 密钥）添加到远程仓库。如果您已添加此信息，请参阅“从仓库中删除敏感数据”。

将现有源代码添加到 GitHub

如果您在计算机上本地存储了由 Git 跟踪或未由任何版本控制系统 (VCS) 跟踪的源代码，则可以通过在终端中键入命令将代码添加到 GitHub。您可以直接键入 Git 命令来执行此操作。或者，您可以使用 GitHub CLI 或 GitHub Desktop。

使用 GitHub CLI

GitHub CLI 是一种开源工具，用于从计算机的命令行使用 GitHub。GitHub CLI 可以使用命令行简化将现有项目添加到 GitHub 的过程。要了解有关 GitHub CLI 的更多信息，请参阅“关于 GitHub CLI”。

使用 GitHub Desktop

如果您最习惯使用点击式用户界面，请考虑使用 GitHub Desktop 添加您的项目。有关更多信息，请参阅“将仓库从本地计算机添加到 GitHub Desktop”。

转换来自其他 VCS 的仓库

如果您的源代码由其他 VCS（例如 Mercurial、Subversion 或 Team Foundation 版本控制）跟踪，则必须先将仓库转换为 Git，然后才能将项目添加到 GitHub。

初始化 Git 仓库

如果您的本地代码未被任何版本控制系统 (VCS) 跟踪，第一步是初始化一个 Git 仓库。如果您的项目已被 Git 跟踪，请跳至“使用命令行导入 Git 仓库”。

打开终端终端Git Bash。
导航到项目根目录。
将本地目录初始化为 Git 仓库。默认情况下，初始分支名为main。

如果您使用的是 Git 2.28.0 或更高版本，可以使用-b设置默认分支名称。
```
git init -b main
```
如果您使用的是 Git 2.27.1 或更早版本，可以使用git symbolic-ref设置默认分支名称。
```
git init && git symbolic-ref HEAD refs/heads/main
```

添加新本地仓库中的文件。这将为首次提交做好准备。

$ git add .
# Adds the files in the local repository and stages them for commit. To unstage a file, use 'git reset HEAD YOUR-FILE'.

提交您已在本地仓库中暂存的文件。

$ git commit -m "First commit"
# Commits the tracked changes and prepares them to be pushed to a remote repository. To remove this commit and modify the file, use 'git reset --soft HEAD~1' and commit and add the file again.

使用命令行导入 Git 仓库

初始化 Git 仓库后，您可以使用 GitHub CLI 或 Git 将仓库推送到 GitHub。

“使用 GitHub CLI 将本地仓库添加到 GitHub”
“使用 Git 将本地仓库添加到 GitHub”

使用 GitHub CLI 将本地仓库添加到 GitHub

要为您的项目在 GitHub 上创建一个仓库，请使用gh repo create子命令。出现提示时，选择**将现有本地仓库推送到 GitHub**并输入所需的仓库名称。如果您希望您的项目属于组织而不是您的用户帐户，请使用组织名称/项目名称指定组织名称和项目名称。
按照交互式提示操作。要添加远程仓库并推送仓库，当询问是否添加远程仓库并将提交推送到当前分支时，请确认“是”。
或者，要跳过所有提示，请使用--source标志提供仓库路径，并传递可见性标志（--public、--private或--internal）。例如，gh repo create --source=. --public。使用--remote标志指定远程仓库。要推送您的提交，请传递--push标志。有关可能参数的更多信息，请参阅GitHub CLI 手册。

使用 Git 将本地仓库添加到 GitHub

在您可以使用 Git 将本地仓库添加到 GitHub 之前，必须先在命令行上对 GitHub 进行身份验证。有关更多信息，请参阅“关于 GitHub 身份验证”。

在 GitHub 上创建一个新的仓库。为避免错误，请不要使用 README、许可证或 gitignore 文件初始化新仓库。您可以在项目推送到 GitHub 后添加这些文件。有关更多信息，请参阅“创建新的仓库”。
在 GitHub 仓库的快速设置页面顶部，单击复制远程仓库 URL。
打开终端终端Git Bash。
将当前工作目录更改为本地项目。
要添加将推送本地仓库的远程仓库的 URL，请运行以下命令。将远程-URL替换为 GitHub 上仓库的完整 URL。
```
git remote add origin REMOTE-URL
```
有关更多信息，请参阅“管理远程仓库”。
要验证您是否正确设置了远程 URL，请运行以下命令。
```
git remote -v
```
要将本地仓库中的更改推送到 GitHub，请运行以下命令。
```
git push -u origin main
```
如果您的默认分支名称不是“main”，请将“main”替换为默认分支的名称。有关更多信息，请参阅“关于分支”。

在 GitHub 上创建一个新的仓库。为避免错误，请不要使用 README、许可证或 gitignore 文件初始化新仓库。您可以在项目推送到 GitHub 后添加这些文件。有关更多信息，请参阅“创建新的仓库”。
在 GitHub 仓库的快速设置页面顶部，单击复制远程仓库 URL。
打开终端终端Git Bash。
将当前工作目录更改为本地项目。
要添加将推送本地仓库的远程仓库的 URL，请运行以下命令。将远程-URL替换为 GitHub 上仓库的完整 URL。
```
git remote add origin REMOTE-URL
```
有关更多信息，请参阅“管理远程仓库”。
要验证您是否正确设置了远程 URL，请运行以下命令。
```
git remote -v
```
要将本地仓库中的更改推送到 GitHub，请运行以下命令。
```
git push origin main
```
如果您的默认分支名称不是“main”，请将“main”替换为默认分支的名称。有关更多信息，请参阅“关于分支”。

在 GitHub 上创建一个新的仓库。为避免错误，请不要使用 README、许可证或 gitignore 文件初始化新仓库。您可以在项目推送到 GitHub 后添加这些文件。有关更多信息，请参阅“创建新的仓库”。
在 GitHub 仓库的快速设置页面顶部，单击复制远程仓库 URL。
打开终端终端Git Bash。
将当前工作目录更改为本地项目。
要添加将推送本地仓库的远程仓库的 URL，请运行以下命令。将远程-URL替换为 GitHub 上仓库的完整 URL。
```
git remote add origin REMOTE-URL
```
有关更多信息，请参阅“管理远程仓库”。
要验证您是否正确设置了远程 URL，请运行以下命令。
```
git remote -v
```
要将本地仓库中的更改推送到 GitHub，请运行以下命令。
```
git push origin main
```
如果您的默认分支名称不是“main”，请将“main”替换为默认分支的名称。有关更多信息，请参阅“关于分支”。

进一步阅读

“向仓库添加文件”
“排查 2 GB 推送限制问题”

平台导航

本文内容