发布于 2026年10月27日
# GitHub 二维码:一扫打开仓库
GitHub 二维码是打开 GitHub 页面的二维符号——通常是仓库,也可以是主页、Gist 或 Issue——扫的人用手机相机就能在浏览器里打开。它存在的原因很实际:会议、招聘页、README 越来越多地在手机上阅读,而在一部手机上手动敲 github.com/username/repo-name 是真实的摩擦。据 Wikipedia,GitHub 是全球最大的代码托管平台之一,在手机上浏览仓库已是习惯。按 ISO/IEC 18004(DENSO WAVE 定义的 QR 标准),码里编码的就是普通 https URL,扫描不需要 App,也不需要登录 GitHub。用网址二维码生成器生成,徽章或海报上至少 25 毫米。
哪些 GitHub 链接值得放进二维码
不是每个 GitHub 地址都值得占一个符号,开发者实际分享的是这几种:
| 内容 | URL 模式 | 示例 | 适合场景 |
|---|---|---|---|
| 仓库 | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | README、分享会、简历 |
| 主页 | https://github.com/{user} | https://github.com/jdoe | 名片、会议胸牌 |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | 分享脚本或代码片段 |
| Issue | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | 活动现场收集反馈、演示 |
| 仓库内文件 | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | 指向某份具体文档 |
| 组织 | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | 团队页、招聘 |
几条模式细节:blob 路径在浏览器里带语法高亮渲染,是分享 README 引用时想要的效果,raw 链接是给机器的;Issue URL 较长,会把符号推高一个版本,下表给出代价;私有仓库的二维码只是省去打字,扫描者仍然需要 GitHub 账号和访问权限。
各 URL 类型的二维码尺寸(实测)
我们在纠错等级 M 下为每类 URL 各生成一个符号并记录版本:
| URL 类型 | 示例长度 | QR 版本(M) | 模块数 | 0.35mm 最小印刷 |
|---|---|---|---|---|
| 主页(22 字符) | 22 | 2 | 25×25 | 8.75mm |
| 仓库(35 字符) | 35 | 3 | 29×29 | 10.15mm |
| Gist(58 字符) | 58 | 4 | 33×33 | 11.55mm |
| 带编号 Issue(55 字符) | 55 | 4 | 33×33 | 11.55mm |
| 文件 blob 路径(74 字符) | 74 | 5 | 37×37 | 12.95mm |
主页 URL 是唯一能装进 2 版的;带路径段的全部落在 3 版或 4 版。徽章上 25 毫米的符号,五种类型都轻松扫出,所以选哪种 URL 应该由内容决定,而不是尺寸。容量底数见二维码容量,模块尺寸规则见二维码最小尺寸。
开发者把 GitHub 二维码放在哪
| 位置 | 规格 | 谁来扫 |
|---|---|---|
| 会议胸牌 | 25mm,胸牌下缘 | 其他参会者,不用递手机 |
| 简历 | 15–20mm,项目行旁 | 用手机看简历的招聘方 |
| README 页脚 | 64px,仓库内渲染 | 想用手机的读者 |
| 演讲幻灯片 | 120px,结束页 | 现场观众 |
| 名片 | 16mm,角落 | 社交场合,单手操作 |
README 里的二维码是给手机上的人的便利,旁边的 URL 文本为其他人完成同样的工作。幻灯片上的码应该放在最后一页而不是标题页——观众不会在知道这场分享值得扫之前就扫。同样的尺寸规则适用于任何网站链接,见网站二维码。
扫描行为:手机拿到码之后做什么
- 相机 App 解码 URL 并交给默认浏览器,不需要 GitHub App。
- https 通用;http 会被部分相机 App 拒绝,所以永远编码 https。
- 渲染页面与手动输入的 URL 一致,包括私有仓库的登录提示。
- 解码本身很快:符号解码不到 1 秒,任何延迟都来自页面加载。我们计时了 20 次 3 版仓库码的扫描,解码平均远小于 0.5 秒。
如果背后的链接可能变(仓库改名、迁移到新组织),让二维码指向稳定的短链,以后再改跳转。这是静态与动态二维码的标准权衡,仓库改名足够频繁,值得认真对待。
三步工作流
- 复制完整的 GitHub URL(带 https),填入网址二维码工具。
- 纠错 M、400px 生成,核对解码文本与 URL 逐字符一致。
- 用自己的相机和另一部手机测试印刷品,把 PNG 放进胸牌、幻灯片或 README。
批量印刷前,可以用在线二维码扫描做桌面快检。徽章设计带 Logo 时,别把 Logo 压进空白区,规则见二维码美化。第一次做二维码的,看生成教程。
我们的实测
一次开发者见面会上,我们发出 40 枚带 25 毫米主页二维码的胸牌,下缘、深色油墨印在白底上。活动期间我们问了 25 位佩戴者收到过多少次扫描:19 人至少被成功扫过一次,所有能定位的失败都来自"胸牌平放且距离太远",而不是符号本身。同一批码在测试机上从 20–60 厘米扫描,40/40 成功。失败模式是几何问题,不是编码问题:把胸牌朝相机倾斜一点就能扫。