Skip to main content

将本地托管代码添加到 GitHub

如果代码存储在本地计算机上并由 Git 跟踪或未由任何版本控制系统 (VCS) 跟踪,你可以使用 GitHub CLI 或 Git 命令将代码导入 GitHub。

Platform navigation

关于将现有源代码添加到 GitHub

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

如果计算机上本地存储了由 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``commitpush 敏感信息到远程存储库。 敏感信息包括但不限于:

有关详细信息,请参阅“从存储库中删除敏感数据”。

初始化 Git 存储库

如果本地托管的代码未由任何 VCS 跟踪,则第一步是初始化 Git 存储库。 如果项目已由 Git 跟踪,请跳至“使用命令行导入 Git 存储库”。

  1. 打开终端终端Git Bash

  2. 导航到项目的根目录。

  3. 将本地目录初始化为 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
    
  4. 在新的本地仓库中添加文件。 这会暂存它们用于第一次提交。

    $ git add .
    # Adds the files in the local repository and stages them for commit. 若要取消暂存文件,请使用“git reset HEAD YOUR-FILE”。
    
  5. 提交暂存在本地仓库中的文件。

    $ 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

  1. 要在 GitHub 上为项目创建存储库,请使用 gh repo create 子命令。 出现提示时,选择“将现有本地存储库推送到 GitHub”****,并输入存储库所需名称。 如果希望项目属于某个组织而不是你的用户帐户,请使用 organization-name/project-name 指定组织名称和项目名称。

  2. 按照交互式提示进行操作。 要添加远程并推送存储库,请在被要求添加远程并将提交推送到当前分支时确认“是”。

  3. 或者,若要跳过提示,请使用 --source 标志提供存储库的路径,并传递可见性标志(--public--private--internal)。 例如 gh repo create --source=. --public。 使用 --remote 标志指定远程。 要推送提交,请传递 --push 标志。 有关可能的参数的详细信息,请参阅 GitHub CLI 手册

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

在使用 Git 将本地存储库添加到 GitHub 之前,必须在命令行中向 GitHub 进行身份验证。 有关详细信息,请参阅“关于向 GitHub 验证”。

  1. 在 GitHub.com 上创建一个新存储库。 为避免错误,请勿使用 README、许可或 gitignore 文件初始化新存储库。 您可以在项目推送到 GitHub 之后添加这些文件。 有关详细信息,请参阅“创建新仓库”。

  2. 在 GitHub.com 的“快速设置”页上的存储库顶部,单击 以复制远程存储库 URL。

    存储库中“快速设置”标头的屏幕截图。 在远程 URL 旁边,两个正方形相重叠的图标以橙色边框突出显示。

  3. 打开终端终端Git Bash

  4. 将当前工作目录更改为您的本地仓库。

  5. 要添加远程存储库的 URL(将在其中推送本地存储库),请运行以下命令。 将 REMOTE-URL 替换为 GitHub 上的存储库完整 URL。

    git remote add origin REMOTE-URL
    

    有关详细信息,请参阅“管理远程仓库”。

  6. 要验证远程 URL 设置是否正确,请运行以下命令。

    git remote -v
    
  7. 要将本地存储库的更改推送到 GitHub.com,请运行以下命令。

    git push -u origin main
    

    如果默认分支并非名为“main”,请将“main”替换为默认分支的名称。 有关详细信息,请参阅“关于分支”。

  1. 在 GitHub.com 上创建一个新存储库。 为避免错误,请勿使用 README、许可或 gitignore 文件初始化新存储库。 您可以在项目推送到 GitHub 之后添加这些文件。 有关详细信息,请参阅“创建新仓库”。

  2. 在 GitHub.com 的“快速设置”页上的存储库顶部,单击 以复制远程存储库 URL。

    存储库中“快速设置”标头的屏幕截图。 在远程 URL 旁边,两个正方形相重叠的图标以橙色边框突出显示。

  3. 打开终端终端Git Bash

  4. 将当前工作目录更改为您的本地仓库。

  5. 要添加远程存储库的 URL(将在其中推送本地存储库),请运行以下命令。 将 REMOTE-URL 替换为 GitHub 上的存储库完整 URL。

    git remote add origin REMOTE-URL
    

    有关详细信息,请参阅“管理远程仓库”。

  6. 要验证远程 URL 设置是否正确,请运行以下命令。

    git remote -v
    
  7. 要将本地存储库的更改推送到 GitHub.com,请运行以下命令。

    git push origin main
    

    如果默认分支并非名为“main”,请将“main”替换为默认分支的名称。 有关详细信息,请参阅“关于分支”。

  1. 在 GitHub.com 上创建一个新存储库。 为避免错误,请勿使用 README、许可或 gitignore 文件初始化新存储库。 您可以在项目推送到 GitHub 之后添加这些文件。 有关详细信息,请参阅“创建新仓库”。

  2. 在 GitHub.com 的“快速设置”页上的存储库顶部,单击 以复制远程存储库 URL。

    存储库中“快速设置”标头的屏幕截图。 在远程 URL 旁边,两个正方形相重叠的图标以橙色边框突出显示。

  3. 打开终端终端Git Bash

  4. 将当前工作目录更改为您的本地仓库。

  5. 要添加远程存储库的 URL(将在其中推送本地存储库),请运行以下命令。 将 REMOTE-URL 替换为 GitHub 上的存储库完整 URL。

    git remote add origin REMOTE-URL
    

    有关详细信息,请参阅“管理远程仓库”。

  6. 要验证远程 URL 设置是否正确,请运行以下命令。

    git remote -v
    
  7. 要将本地存储库的更改推送到 GitHub.com,请运行以下命令。

    git push origin main
    

    如果默认分支并非名为“main”,请将“main”替换为默认分支的名称。 有关详细信息,请参阅“关于分支”。

延伸阅读