使用主题对存储库进行分类

为了帮助其他人找到您的项目并为其做出贡献，您可以向存储库添加与项目的预期目的、主题领域、亲和组或其他重要品质相关的主题。

本文中

关于主题

借助主题，你可以探索特定学科领域的代码库，找到可以贡献的项目，并发现解决特定问题的全新解决方案。主题显示在代码库的主页上。你可以单击主题名称，查看相关主题以及分类到该主题的其他代码库列表。

Screenshot of the github/docs repository. In the right sidebar, three topics are outlined in dark orange: "docs," "hacktoberfest," and "works-with-codespaces."

要浏览使用最多的主题，请访问 https://github.com/topics/。

你可以在 github/explore 代码库中为 GitHub 的精选主题集做出贡献。

代码库管理员可以向代码库添加他们想要的任何主题。用于对代码库进行分类的有用主题包括代码库的预期用途、学科领域、社区或语言。此外，GitHub 会分析公共代码库内容并生成代码库管理员可以接受或拒绝的建议主题。不会分析私有代码库内容，也不会收到主题建议。

公共和私有代码库可以有主题，但你只会在主题搜索结果中看到你可以访问的私有代码库。

你可以搜索与特定主题关联的代码库。有关更多信息，请参阅“搜索代码库”。你还可以搜索 GitHub 上的主题列表。有关更多信息，请参阅“搜索主题”。

创建主题时

  • 使用小写字母、数字和连字符。
  • 使用 50 个字符或更少字符。
  • 最多添加 20 个主题。

向你的代码库添加主题

注意：即使你从私有代码库中创建主题，主题名称始终是公开的。

  1. 在 GitHub.com 上，导航到代码库的主页。

  2. 在页面的右上角，“关于”的右侧，单击 .

    Screenshot of the top right of the main page for a repository. The "Edit repository metadata" button, shown as a gear icon, is outlined in orange.

  3. 在“主题”下，开始输入你想要添加到代码库的主题，以显示匹配主题的下拉菜单。单击你想要添加的主题或继续输入以创建新主题。

    Screenshot of the "Topics" field showing example topics: "docs" and "works-with-codespaces." A "Suggested" topic "documentation" is shown below.

  4. 可选，如果“主题”字段下显示“建议”主题，请单击 以添加或 以拒绝建议的主题。

  5. 添加完主题后，单击保存更改。