将本地托管代码添加到 GitHub

关于导入源代码

通过将源代码导入到 GitHub，可让你和其他人更轻松地协作处理项目和管理代码。 GitHub 可助你协作、跟踪更改和组织任务，从而更轻松地生成和管理项目。有关详细信息，请参阅“关于 GitHub 和 Git”。

Warning

切勿将敏感信息（例如密码或 API 密钥）git add、commit 或 push 到远程存储库。如果已添加此信息，请参阅从存储库中删除敏感数据。

将现有源代码添加到 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

要在 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”替换为默认分支的名称。有关详细信息，请参阅“关于分支”。

Platform navigation

本文内容