Skip to main content

将本地托管代码添加到 GitHub

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

Platform navigation

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

  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
    
  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
    
  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
    

延伸阅读