Skip to main content

创建存储库

若要将项目放在 GitHub 上,需要创建一个存储库来存放它。

创建存储库

您可以在 GitHub Enterprise Server 仓库中存储各种项目,包括内部来源项目。 通过内部源代码,您可以分享代码来获取更好、更可靠的软件。 有关内部来源的详细信息,请参阅 GitHub 的白皮书内部来源简介

  1. 在任何页面的右上角,使用 下拉菜单选择“新建存储库”。 包含创建新存储库选项的下拉菜单
  2. 为存储库键入简短好记的名称。 例如 "hello-world"。 用于输入存储库名称的字段
  3. 可以选择性地添加存储库的说明。 例如,“我在 GitHub Enterprise Server 上的第一个仓库”。 用于输入存储库说明的字段 1. 选择仓库可见性。 有关详细信息,请参阅“关于存储库”。 用于选择存储库可见性的单选按钮 1. 选择“使用 README 初始化此存储库”。 “使用自述文件初始化此存储库”复选框 1. 单击“创建存储库”。 创建存储库的按钮

恭喜! 你已经成功创建了第一个存储库,并使用自述文件对其进行了初始化。

若要详细了解 GitHub CLI,请参阅“关于 GitHub CLI”。

  1. 在命令行中,导航到要在其中创建新项目的本地克隆的目录。
  2. 若要为项目创建存储库,请使用 gh repo create 子命令。 出现提示时,选择“从头开始在 GitHub 上创建新存储库”,然后输入新项目的名称 如果希望项目属于某个组织而不是你的个人帐户,请使用 organization-name/project-name 指定组织名称和项目名称。
  3. 按照交互式提示进行操作。 要在本地克隆存储库,请在询问您是否要克隆远程项目目录时确认是。
  4. 或者,若要跳过提示,请提供存储库名称和可见性标志(--public--private--internal)。 例如 gh repo create project-name --public。 若要在本地克隆存储库,请传递 --clone 标志。 有关可能的参数的详细信息,请参阅 GitHub CLI 手册

提交您的第一个更改

提交 就像是项目中所有文件在特定时间点的快照。

创建新存储库时,你使用自述文件对其进行了初始化。 README 文件用于更详细地描述项目或添加一些指南性文档(例如如何安装或使用项目)。 README 文件的内容会自动显示在存储库的首页上。

让我们提交对自述文件的更改。

  1. 在存储库的文件列表中,单击“README.md”。 文件列表中的自述文件
  2. 在文件内容上方,单击
  3. 在“编辑文件”选项卡上,键入一些关于你自己的信息。 文件中的新内容 1. 在新内容的上方,单击“预览更改”。 “文件预览”按钮
  4. 查看您对文件所做的更改。 你会看到新内容以绿色显示。 文件预览视图 1. 在页面底部,输入一条简短、有意义的提交消息,描述您对文件所作的更改。 您可以在提交消息中将提交归于多个作者。 有关详细信息,请参阅“创建具有多个共同作者的提交”。 更改的提交消息 1. 在提交消息字段下面,确定是要将提交添加到当前分支还是新分支。 如果当前分支是默认分支,则应选择为提交创建新分支,然后创建拉取请求。 有关详细信息,请参阅“创建新的拉取请求”。 提交分支选项 1. 单击“提议文件更改”。 提议文件更改按钮

创建项目后,可以开始提交更改。

README 文件用于更详细地描述项目或添加一些指南性文档(例如如何安装或使用项目)。 README 文件的内容会自动显示在存储库的首页上。 按照以下步骤添加一个自述文件。

  1. 在命令行中,导航到新项目的根目录。 (此目录是在运行 gh repo create 命令时创建的。)

  2. 创建自述文件,其中包含有关项目的一些信息。

    echo "info about this project" >> README.md
  3. 输入 git status。 你会看到你有一个未跟踪的 README.md 文件。

    $ git status
    
    Untracked files:
      (use "git add ..." to include in what will be committed)
      README.md
    
    nothing added to commit but untracked files present (use "git add" to track)
  4. 暂存并提交文件。

    git add README.md && git commit -m "Add README"
  5. 将更改推送到您的分支。

    git push --set-upstream origin HEAD

后续步骤

你现在已经创建了一个存储库,其中包括自述文件,并在 your GitHub Enterprise Server instance 上创建了你的第一个提交。

  • 现在可以克隆 GitHub 存储库以在计算机上创建本地副本。 从您的本地仓库,您可以提交并创建拉取请求来更新上游仓库中的更改。 有关详细信息,请参阅克隆存储库设置 Git
  • 可以在 GitHub 上找到有趣的项目和存储库,并通过创建存储库分支来更改它们。 为存储库创建分支可以在不影响原始存储库的情况下更改另一个存储库。 有关详细信息,请参阅“为存储库创建分支”。

  • GitHub 中的每个仓库均归个人或组织所有。 您可以在 GitHub Enterprise Server 上连接和关注人员、仓库和组织以与之进行交互。 有关详细信息,请参阅“社交化”。

  • GitHub 有一个强大的支持社区,你可以在那里寻求帮助并与来自世界各地的人交谈。 加入 GitHub Community 上的对话。