Skip to main content

管理个人资料自述文件

可以向您的 GitHub 个人资料添加自述文件以向其他人介绍自己。

谁可以使用此功能?

Profile READMEs are not available to 托管用户帐户.

关于您的个人资料自述文件

可以通过创建个人资料 README,在 GitHub 上与社区分享有关你自己的信息。 GitHub 在个人资料页面的顶部显示您的个人资料自述文件。

您决定在个人资料自述文件中包含哪些信息,因此您可以完全控制如何在 GitHub 上展示自己。 以下是访客可能在您的个人资料自述文件中找到感兴趣、有趣或有用信息的一些示例。

  • “About me(关于我)”部分介绍您的工作和兴趣。
  • 您引以为豪的贡献以及这些贡献的背景信息
  • 在您参与的社区获得帮助的指南

@octocato 的个人资料页面的屏幕截图。 在右上角,个人资料自述文件问候查看者,并列出有关用户工作的信息。

您可以使用 GitHub Flavored Markdown 在个人资料自述文件中设置文本格式和包含表情符号、图像及 GIF。 有关详细信息,请参阅“Getting started with writing and formatting on GitHub(GitHub 写作和格式设置入门)”。 有关自定义个人资料 README 的实践指南,请参阅“有关在 GitHub 上编写的快速入门”。

先决条件

如果满足以下所有条件,GitHub 将在你的个人资料页面显示你的个人资料自述文件。

  • 您使用与您的 GitHub 用户名匹配的名称创建了仓库。
  • 该仓库为公共仓库。
  • 仓库的根目录中包含名为 README.md 的文件。
  • README.md 文件包含任何内容。

注意:如果你在 2020 年 7 月之前创建了一个与你的用户名同名的公共存储库,GitHub 将不会自动在你的个人资料中显示该存储库的自述文件。 可以通过转到 GitHub 上的存储库并单击共享到个人资料,手动将存储库的自述文件共享到你的个人资料。

添加个人资料自述文件

  1. 在任何页面的右上角,选择 ,然后单击“新建存储库”。

    GitHub 下拉菜单的屏幕截图,其中显示了用于创建新项的选项。 菜单项“新建存储库”用深橙色框标出。

  2. 在“Repository name(仓库名称)”下,输入与您的 GitHub 用户名匹配的仓库名称。 例如,如果您的用户名是 "octocat",则仓库名称必须为 "octocat"。

  3. (可选)在“描述”字段中键入存储库的描述。 例如,“My personal repository(我的个人仓库)”。

  4. 选择“公共”。

  5. 选择“使用 README 初始化此存储库”。

  6. 单击“创建存储库”。

  7. 在右边栏上方,单击“编辑自述文件”。

生成的自述文件用模板预先填充,为您创建个人资料自述文件提供一些启发。

有关所有可用表情符号及其代码的摘要,请参阅“表情符号备忘单”。

删除个人资料自述文件

如果出现以下任何一种情况,系统将从您的 GitHub 配置文件中移除配置文件 README:

  • 自述文件已被移除或为空。
  • 存储库为专用。
  • 由于其中一个名称发生更改或者两个名称都发生了更改,存储库名称不再与用户名一致。

您选择的方法取决于您的需求,但如果您不确定,我们建议您将仓库设为私有。 有关如何将存储库设为专用的步骤,请参阅“设置存储库可见性”。

延伸阅读