如何自定义GitHub概览页？请求自定义操作方法指导

核心前提：创建同名公开仓库 #

GitHub的自定义概览页依赖一个和你用户名完全一致的公开仓库，步骤如下：

• 登录GitHub，点击右上角「New repository」
• 仓库名称必须和你的GitHub用户名完全匹配（大小写也要一致）
• 勾选「Public」权限，再勾选「Add a README file」，最后点击「Create repository」
• 完成后，你的个人主页会自动加载这个仓库的README内容作为概览页

编辑README.md自定义内容 #

进入这个同名仓库，点击README.md右上角的铅笔图标开始编辑，用Markdown语法自由定制：

• 添加个人简介：

  ### 关于我
  后端开发者，专注Python和Go，喜欢折腾开源项目。
  

• 列出技能栈：
  • Python/Go
  • Docker/Kubernetes
  • MySQL/Redis
• 展示常用代码片段：

  # 快速克隆自己的仓库
  git clone git@github.com:your-username/target-repo.git
  

• 插入本地图片：先把图片上传到仓库的assets文件夹，再用相对路径引用：

  ![个人项目截图](./assets/demo-project.png)
  

进阶：用GitHub Actions动态更新内容 #

如果想让概览页自动更新（比如展示最新项目、提交记录），可以添加GitHub Actions工作流：

1. 在仓库根目录创建.github/workflows文件夹
2. 创建update-readme.yml文件，写入以下示例工作流（替换your-username为你的实际用户名）：

   name: Update README
   on:
     schedule:
       - cron: '0 0 * * *' # 每天凌晨自动更新
     workflow_dispatch: # 支持手动触发
   
   jobs:
     update-readme:
       runs-on: ubuntu-latest
       steps:
         - uses: actions/checkout@v4
         - name: 写入最新项目列表
           run: |
             # 清空原有项目列表（可根据你的README结构调整）
             sed -i '/## 最近更新的项目/q' README.md
             echo "## 最近更新的项目" >> README.md
             # 获取最近5个仓库
             git ls-remote --heads https://github.com/your-username/ | head -5 | awk '{gsub("refs/heads/","",$2); print "- " $2}' >> README.md
         - name: 提交更新
           run: |
             git config --local user.name "github-actions[bot]"
             git config --local user.email "github-actions[bot]@users.noreply.github.com"
             git add README.md
             git commit -m "Auto-update README with latest projects" || echo "No changes to commit"
             git push
   

常见问题排查 #

• 概览页不显示：检查仓库名称是否和用户名完全一致、仓库是否为公开状态、是否存在README.md文件
• 编辑后内容不生效：刷新页面等待1-2分钟，或检查提交记录是否成功

内容的提问来源于stack exchange，提问作者Abdullah Al Mahmud