关于将现有源代码添加到 GitHub
如果计算机上本地存储了由 Git 跟踪或未由任何版本控制系统 (VCS) 跟踪的源代码,你可以通过在终端中键入命令将代码添加到 GitHub。 也可以通过直接键入 Git 命令或使用 GitHub CLI 来执行此操作。
GitHub CLI 是用于从计算机的命令行使用 GitHub 的开源工具。 GitHub CLI 可以简化使用命令行将现有项目添加到 GitHub 的过程。 若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。
注意:如果你最喜欢点按式用户界面,请考虑改用 GitHub Desktop 添加项目。 有关详细信息,请参阅“将仓库从本地计算机添加到 GitHub Desktop”。
如果源代码由其他 VCS(例如 Mercurial、Subversion 或 Team Foundation 版本控制)跟踪,则必须先将存储库转换为 Git,然后才能将项目添加到 GitHub。
警告:从不 git add``commit
或 push
敏感信息到远程存储库。 敏感信息包括但不限于:
- 密码
- SSH 密钥
- AWS 访问密钥
- API 密钥
- 信用卡号
- PIN 号码
有关详细信息,请参阅“从存储库中删除敏感数据”。
初始化 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
-
在 GitHub.com 上创建一个新存储库。 为避免错误,请勿使用 README、许可或 gitignore 文件初始化新存储库。 您可以在项目推送到 GitHub 之后添加这些文件。 有关详细信息,请参阅“创建新仓库”。
-
在 GitHub.com 的“快速设置”页上的存储库顶部,单击 以复制远程存储库 URL。
-
打开终端终端Git Bash。
-
将当前工作目录更改为您的本地仓库。
-
要添加远程存储库的 URL(将在其中推送本地存储库),请运行以下命令。 将
REMOTE-URL
替换为 GitHub 上的存储库完整 URL。git remote add origin REMOTE-URL
有关详细信息,请参阅“管理远程仓库”。
-
要验证远程 URL 设置是否正确,请运行以下命令。
git remote -v
-
要将本地存储库的更改推送到 GitHub.com,请运行以下命令。
git push -u origin main
-
在 GitHub.com 上创建一个新存储库。 为避免错误,请勿使用 README、许可或 gitignore 文件初始化新存储库。 您可以在项目推送到 GitHub 之后添加这些文件。 有关详细信息,请参阅“创建新仓库”。
-
在 GitHub.com 的“快速设置”页上的存储库顶部,单击 以复制远程存储库 URL。
-
打开终端终端Git Bash。
-
将当前工作目录更改为您的本地仓库。
-
要添加远程存储库的 URL(将在其中推送本地存储库),请运行以下命令。 将
REMOTE-URL
替换为 GitHub 上的存储库完整 URL。git remote add origin REMOTE-URL
有关详细信息,请参阅“管理远程仓库”。
-
要验证远程 URL 设置是否正确,请运行以下命令。
git remote -v
-
要将本地存储库的更改推送到 GitHub.com,请运行以下命令。
git push origin main
-
在 GitHub.com 上创建一个新存储库。 为避免错误,请勿使用 README、许可或 gitignore 文件初始化新存储库。 您可以在项目推送到 GitHub 之后添加这些文件。 有关详细信息,请参阅“创建新仓库”。
-
在 GitHub.com 的“快速设置”页上的存储库顶部,单击 以复制远程存储库 URL。
-
打开终端终端Git Bash。
-
将当前工作目录更改为您的本地仓库。
-
要添加远程存储库的 URL(将在其中推送本地存储库),请运行以下命令。 将
REMOTE-URL
替换为 GitHub 上的存储库完整 URL。git remote add origin REMOTE-URL
有关详细信息,请参阅“管理远程仓库”。
-
要验证远程 URL 设置是否正确,请运行以下命令。
git remote -v
-
要将本地存储库的更改推送到 GitHub.com,请运行以下命令。
git push origin main
延伸阅读
- “添加文件到仓库”
- “2 GB 推送限制疑难解答”