将本地托管代码添加到 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. 若要取消暂存文件，请使用“git reset HEAD YOUR-FILE”。

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

$ git commit -m "First commit"
# Commits the tracked changes and prepares them to be pushed to a remote repository. 要删除此提交并修改文件，请使用 'git reset --soft HEAD~1' 并再次提交和添加文件。

使用命令行导入 Git 存储库

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

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

使用 GitHub CLI 将本地存储库添加到 GitHub

要在 GitHub 上为项目创建存储库，请使用 gh repo create 子命令。出现提示时，选择“将现有本地存储库推送到 GitHub”****，并输入存储库所需名称。如果希望项目属于某个组织而不是你的用户帐户，请使用 ORGANIZATION-NAME/PROJECT-NAME 指定组织名称和项目名称。
按照交互式提示进行操作。要添加远程并推送存储库，请在被要求添加远程并将提交推送到当前分支时确认“是”。
或者，若要跳过提示，请使用 --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（将在其中推送本地存储库），请运行以下命令。将 REMOTE-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（将在其中推送本地存储库），请运行以下命令。将 REMOTE-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（将在其中推送本地存储库），请运行以下命令。将 REMOTE-URL 替换为 GitHub 上的存储库完整 URL。
```
git remote add origin REMOTE-URL
```
有关详细信息，请参阅“管理远程仓库”。
要验证远程 URL 设置是否正确，请运行以下命令。
```
git remote -v
```
要将本地存储库的更改推送到 GitHub，请运行以下命令。
```
git push origin main
```
如果默认分支并非名为“main”，请将“main”替换为默认分支的名称。有关详细信息，请参阅“关于分支”。

延伸阅读

“添加文件到仓库”
“2 GB 推送限制疑难解答”