跳至主要内容

将本地托管代码添加到 GitHub

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

平台导航

关于将源代码导入 GitHub

将源代码导入 GitHub,可以让你和其他人更轻松地协作项目并管理代码。GitHub 帮助你协作、跟踪更改和组织任务,让构建和管理项目变得更简单。有关更多信息,请参阅“关于 GitHub 和 Git”。

警告:切勿将敏感信息(例如密码或 API 密钥)git addcommitpush 到远程存储库。如果你已经添加了此信息,请参阅“从存储库中删除敏感数据”。

将现有源代码添加到 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 Version Control)跟踪,则必须在将项目添加到 GitHub 之前将存储库转换为 Git。

初始化 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. To unstage a file, use '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. To remove this commit and modify the file, use 'git reset --soft HEAD~1' and commit and add the file again.
    

使用命令行导入 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。

    Screenshot of the "Quick Setup" header in a repository. Next to the remote URL, an icon of two overlapping squares is highlighted with an orange outline.

  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。

    Screenshot of the "Quick Setup" header in a repository. Next to the remote URL, an icon of two overlapping squares is highlighted with an orange outline.

  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。

    Screenshot of the "Quick Setup" header in a repository. Next to the remote URL, an icon of two overlapping squares is highlighted with an orange outline.

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

延伸阅读