跳至主要内容

将本地托管的代码添加到 GitHub

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

平台导航

关于导入源代码

将您的源代码导入 GitHub 可让您和他人更轻松地协作项目并管理代码。GitHub 帮助您协作、跟踪更改并组织任务,使构建和管理项目更为简便。欲了解更多信息,请参阅 关于 GitHub 和 Git

警告

切勿 git addcommitpush 敏感信息(例如密码或 API 密钥)至远程仓库。如果你已经提交了此类信息,请参阅 从仓库中移除敏感数据

将已有源代码添加到 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 的仓库转换为 Git

如果你的源代码是由其他 VCS(如 Mercurial、Subversion 或 Team Foundation Version Control)跟踪的,则必须先将该仓库转换为 Git,才能将项目添加到 GitHub。

初始化 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 子命令。当出现提示时,选择 Push an existing local repository to GitHub 并输入想要的仓库名称。如果希望项目归属于组织而不是个人账户,请使用 组织名称/项目名称ORGANIZATION-NAME/PROJECT-NAME)的格式指定。

  2. 按照交互式提示操作。当系统询问是否添加远程并将提交推送到当前分支时,确认输入 yes。

  3. 如果想跳过所有提示,可使用 --source 标志提供仓库路径,并使用可见性标志(--public--private--internal)。例如 gh repo create --source=. --public。使用 --remote 标志指定远程仓库。若要推送提交,请添加 --push 标志。有关可用参数的更多信息,请参阅 GitHub CLI 手册

使用 Git 将本地仓库添加到 GitHub

在使用 Git 将本地仓库添加到 GitHub 之前,需要先在命令行上完成对 GitHub 的身份验证。更多信息请参阅 关于在命令行中进行 GitHub 身份验证

  1. 在 GitHub 上创建一个新仓库。为避免错误,请不要在新仓库中初始化 README、许可证或 .gitignore 文件。您可以在项目推送到 GitHub 后再添加这些文件。更多信息请参阅 创建新仓库

  2. 在 GitHub “快速设置”页面的仓库顶部,点击复制远程仓库 URL。

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

  3. 打开 终端终端Git Bash

  4. 将当前工作目录更改为本地项目所在目录。

  5. 要为将本地仓库推送到的远程仓库添加 URL,请运行以下命令。将 REMOTE-URL 替换为该仓库在 GitHub 上的完整 URL。

    git remote add origin REMOTE-URL
    

    更多信息请参阅 管理远程仓库

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

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

    git push -u origin main
    

    如果你的默认分支名称不是 “main”,请将 “main” 替换为你的默认分支名称。更多信息请参阅 关于分支

  1. 在 GitHub 上创建一个新仓库。为避免错误,请不要在新仓库中初始化 README、许可证或 .gitignore 文件。您可以在项目推送到 GitHub 后再添加这些文件。更多信息请参阅 创建新仓库

  2. 在 GitHub “快速设置”页面的仓库顶部,点击复制远程仓库 URL。

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

  3. 打开 终端终端Git Bash

  4. 将当前工作目录更改为本地项目所在目录。

  5. 要为将本地仓库推送到的远程仓库添加 URL,请运行以下命令。将 REMOTE-URL 替换为该仓库在 GitHub 上的完整 URL。

    git remote add origin REMOTE-URL
    

    更多信息请参阅 管理远程仓库

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

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

    git push origin main
    

    如果你的默认分支名称不是 “main”,请将 “main” 替换为你的默认分支名称。更多信息请参阅 关于分支

  1. 在 GitHub 上创建一个新仓库。为避免错误,请不要在新仓库中初始化 README、许可证或 .gitignore 文件。您可以在项目推送到 GitHub 后再添加这些文件。更多信息请参阅 创建新仓库

  2. 在 GitHub “快速设置”页面的仓库顶部,点击复制远程仓库 URL。

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

  3. 打开 终端终端Git Bash

  4. 将当前工作目录更改为本地项目所在目录。

  5. 要为将本地仓库推送到的远程仓库添加 URL,请运行以下命令。将 REMOTE-URL 替换为该仓库在 GitHub 上的完整 URL。

    git remote add origin REMOTE-URL
    

    更多信息请参阅 管理远程仓库

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

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

    git push origin main
    

    如果你的默认分支名称不是 “main”,请将 “main” 替换为你的默认分支名称。更多信息请参阅 关于分支

延伸阅读

© . This site is unofficial and not affiliated with GitHub, Inc.