将源代码导入 GitHub,可以让你和其他人更轻松地协作项目并管理代码。GitHub 帮助你协作、跟踪更改和组织任务,让构建和管理项目变得更简单。有关更多信息,请参阅“关于 GitHub 和 Git”。
警告:切勿将敏感信息(例如密码或 API 密钥)git add
、commit
或 push
到远程存储库。如果你已经添加了此信息,请参阅“从存储库中删除敏感数据”。
如果你有存储在计算机本地且由 Git 跟踪或未由任何版本控制系统 (VCS) 跟踪的源代码,你可以通过在终端中键入命令将代码添加到 GitHub。你可以直接键入 Git 命令来执行此操作。或者,你可以使用 GitHub CLI 或 GitHub Desktop。
GitHub CLI 是一款开源工具,可用于通过计算机的命令行使用 GitHub。GitHub CLI 可以简化使用命令行将现有项目添加到 GitHub 的过程。若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。
如果你更习惯于单击式用户界面,请考虑改用 GitHub Desktop 添加项目。有关详细信息,请参阅“将存储库从本地计算机添加到 GitHub Desktop”。
如果你的源代码由其他 VCS(例如 Mercurial、Subversion 或 Team Foundation Version Control)跟踪,则必须在将项目添加到 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 存储库后,您可以使用 GitHub CLI 或 Git 将存储库推送到 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 之前,您必须在命令行上对 GitHub 进行身份验证。有关更多信息,请参阅“关于对 GitHub 进行身份验证”。