码盒
CodeBox

GitHub 二维码:一扫打开仓库

GitHub 二维码里放什么 URL:仓库、主页、Gist、Issue 的链接模式,每种链接实测的二维码尺寸,以及开发者常把码放在哪。

# 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-toolREADME、分享会、简历
主页https://github.com/{user}https://github.com/jdoe名片、会议胸牌
Gisthttps://gist.github.com/{user}/{id}https://gist.github.com/jdoe/9a1b2c分享脚本或代码片段
Issuehttps://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 字符)22225×258.75mm
仓库(35 字符)35329×2910.15mm
Gist(58 字符)58433×3311.55mm
带编号 Issue(55 字符)55433×3311.55mm
文件 blob 路径(74 字符)74537×3712.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 秒。

如果背后的链接可能变(仓库改名、迁移到新组织),让二维码指向稳定的短链,以后再改跳转。这是静态与动态二维码的标准权衡,仓库改名足够频繁,值得认真对待。

三步工作流

  1. 复制完整的 GitHub URL(带 https),填入网址二维码工具。
  2. 纠错 M、400px 生成,核对解码文本与 URL 逐字符一致。
  3. 用自己的相机和另一部手机测试印刷品,把 PNG 放进胸牌、幻灯片或 README。

批量印刷前,可以用在线二维码扫描做桌面快检。徽章设计带 Logo 时,别把 Logo 压进空白区,规则见二维码美化。第一次做二维码的,看生成教程。

我们的实测

一次开发者见面会上,我们发出 40 枚带 25 毫米主页二维码的胸牌,下缘、深色油墨印在白底上。活动期间我们问了 25 位佩戴者收到过多少次扫描:19 人至少被成功扫过一次,所有能定位的失败都来自"胸牌平放且距离太远",而不是符号本身。同一批码在测试机上从 20–60 厘米扫描,40/40 成功。失败模式是几何问题,不是编码问题:把胸牌朝相机倾斜一点就能扫。

常见问题

怎么做 GitHub 仓库的二维码?

复制带 https 的仓库 URL,粘进网址二维码生成器,400px 以上导出;徽章或海报上至少 25 毫米印刷。

二维码能在手机上打开 GitHub 仓库吗?

能。手机相机解码 URL 后仓库在浏览器打开,公共仓库不需要 GitHub App,也不需要登录。

GitHub 二维码应该链到仓库还是主页?

项目分享会、README 用仓库码;一般社交用主页码。主页码还最短,符号最小。

打印的简历上能放 GitHub 二维码吗?

能,15–20 毫米、模块不小于 0.25 毫米;空白区留干净、用深色油墨,招聘方在手机上扫描的反馈都很稳定。

README 里能放 GitHub 二维码吗?

能,64–128px 的图,旁边写上 URL 文本。浏览器里直接渲染,给手机读者一个一键入口。

会议胸牌上 GitHub 二维码最小多大?

约 25 毫米,模块 0.35 毫米,留 4 个模块空白区。主页码(2 版)更小也行,但扫描余量变小。

GitHub 二维码能链到 Issue 或 Pull Request 吗?

能,任何公开的 GitHub URL 都可以,包括 /issues/{n} 和 /pull/{n}。Issue URL 较长,符号落在 4 版。

扫 GitHub 二维码需要装 App 吗?

不需要。现代安卓和 iPhone 相机原生识别二维码,结果直接交给默认浏览器打开。

延伸阅读

联系我们