您的GitHub个人资料图片和README横幅是访客访问您的个人资料时首先看到的内容。正确设置尺寸意味着 清晰、专业的图片,而不是模糊的缩略图或裁剪尴尬的横幅。以下是您需要的所有尺寸。
GitHub个人资料图片(头像)尺寸
GitHub在整个平台以多种尺寸显示个人资料头像:
- 460 × 460 px — 最大存储尺寸(GitHub从此尺寸缩小)。
- 230 × 230 px — 在您的个人资料页面上显示。
- 64 × 64 px — 显示在提交和评论旁边。
- 20 × 20 px — 顶部导航中用户名旁边的小图标。
以500 × 500 px(正方形)或更大尺寸上传头像。GitHub在大多数视图中将其裁剪为 圆形,所以保持面孔、标志或关键视觉元素居中。避免在边缘附近放置文字——它会被隐藏。PNG适合 标志;JPEG适合照片。
GitHub README标题横幅尺寸
个人资料README文件(username/username仓库)可以包含标题图片。GitHub在个人资料 页面上以最大888 px宽度渲染README内容。为了在视网膜屏幕上获得清晰的横幅, 以1776 × 592 px(相同3:1比例的2倍宽度)上传并让CSS缩小,或使用1200 × 400 px作为实用的起始尺寸。
在您的README中,使用以下方式引用图片:
GitHub会自动将其限制在列宽内。
仓库社交预览卡片
当您在社交媒体或Slack消息中分享GitHub仓库链接时,GitHub会显示一个预览卡片。您可以在仓库的设置 → 社交预览下设置自定义Open Graph图片。
GitHub推荐的社交预览尺寸为1280 × 640 px。使用PNG或JPEG;PNG适合带文字 叠加、标志或清晰线条的图片。卡片会被裁剪为2:1比例,所以将所有重要内容保持在中心区域, 避免将关键文字放在任何边缘50 px以内。
组织标志和公司个人资料
GitHub组织标志遵循与个人头像相同的规则:上传正方形图片,最小200 × 200 px, 理想情况下500 × 500 px或更大。组织个人资料README(在.github仓库中) 也以与个人资料README相同的888 px宽度显示。
贡献图和固定仓库缩略图
您个人资料上固定的仓库如果有社交预览图片,会显示一个小缩略图。此缩略图以约400 × 200 px显示——相同的2:1社交预览图片缩小后的效果。清晰、高对比度、 带有大字体的图片即使在这个小尺寸下也能清晰阅读。
为GitHub准备图片
GitHub通过网页UI(拖放到问题或README编辑器中)上传图片的最大文件大小为10 MB。 对于存储在仓库中的横幅图片,请将文件大小控制在1 MB以下,以避免减慢仓库克隆速度。
使用我们的图片调整大小工具达到精确尺寸,使用我们的图片压缩工具在将图片提交到仓库之前减小文件大小。将PNG标志 转换为WebP可以在没有明显差异的情况下减小30至50%的大小。
快速参考表
- 个人资料头像:500 × 500 px(显示为圆形)
- README标题横幅:1200 × 400 px(或1776 × 592 px用于视网膜屏幕)
- 仓库社交预览:1280 × 640 px
- 组织标志:500 × 500 px
- 固定仓库缩略图:使用社交预览,约400 × 200 px显示