公開日 2026-10-27
# GitHub QRコード:リポジトリをワンタップで共有
GitHub QRコードとは、スキャンした人のブラウザでGitHubのページ(通常はリポジトリですが、プロフィール、Gist、Issueも対象)を開く2次元バーコードです。このQRコードが存在する理由は、カンファレンス、求人サイト、READMEファイルがますますスマートフォンで閲覧されるようになったためであり、モバイルキーボードで github.com/username/repo-name を入力するのは大きな手間だからです。Wikipedia記事で解説されているコードホスティングプラットフォームであるGitHubは、リポジトリのモバイル閲覧を一般的な習慣にしました。このQRコードは、DENSO WAVEのQR標準規格であるISO/IEC 18004に従い、通常のhttps URLをエンコードするため、スキャンにはアプリやGitHubログインは不要です。URL QRコード生成でシンボルを生成し、バッジやポスターには少なくとも25mmのサイズで印刷してください。
QRコードとして意味のあるGitHub URL
すべてのGitHubアドレスがQRコード化に値するわけではありません。開発者が実際に共有する主なURLは以下の通りです:
| コンテンツ | 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は長いため、QRシンボルのバージョンが上がります(サイズのコストは以下の表を参照)。また、リポジトリがプライベートの場合、QRコードは入力の手間を省くだけであり、スキャンする側には依然としてGitHubアカウントとアクセス権が必要です。
URLタイプ別のQRサイズ(実測値)
各URLタイプについて、誤り訂正レベルMで1つのシンボルを生成し、バージョンを記録しました:
| URLタイプ | 例の長さ | QRバージョン (M) | モジュール数 | 0.35mmでの最小印刷サイズ |
|---|---|---|---|---|
| プロフィール (22文字) | 22 | 2 | 25 x 25 | 8.75 mm |
| リポジトリ (35文字) | 35 | 3 | 29 x 29 | 10.15 mm |
| Gist (58文字) | 58 | 4 | 33 x 33 | 11.55 mm |
| 番号付きIssue (55文字) | 55 | 4 | 33 x 33 | 11.55 mm |
| ファイルblobパス (74文字) | 74 | 5 | 37 x 37 | 12.95 mm |
プロフィールURLのみがバージョン2のシンボルに収まり、パスセグメントを含むものはすべてバージョン3または4になります。バッジ上の25mmシンボルであれば、5つのタイプすべてが快適にスキャンできるため、URLタイプの選択はサイズではなくコンテンツに基づいて行うべきです。基礎となる容量の数字はQRコードにどれだけのデータを格納できるか?に、モジュールサイズのルールはQRコードの最小サイズはどれくらいか?に記載されています。
開発者が実際にGitHub QRコードを配置する場所
| 配置場所 | 形式 | スキャンする人 |
|---|---|---|
| カンファレンスバッジ | バッジ下部の25mm | 他の参加者(スマホを渡す必要なし) |
| 履歴書やCV | プロジェクト欄の横の15〜20mm | スマホで確認する採用担当者 |
| READMEフッター | リポジトリ内の64px(ブラウザでレンダリング) | モバイルリンクを求めている読者 |
| スピーカーデッキ | 最終スライドの120px | トーク中の聴衆 |
| ビジネスクード | 角の16mm | ネットワーキング(片手での操作) |
README内のQRコードは、スマホを使っている人向けの利便性であり、その横にあるURLテキストは他のすべての人に対して同じ役割を果たします。プレゼン資料のQRコードはタイトルスライドではなく、最終スライドに配置すべきです。トークがスキャンする価値があることを知る前に、人はスキャンしないからです。同じサイズリングルールは、ウェブサイト用QRコード:URLフィールドとリダイレクトの制限で説明されているように、あらゆるウェブサイトリンクにも適用されます。
スキャン動作:スマホがコードに対して行うこと
- カメラアプリがURLをデコードし、デフォルトのブラウザに引き渡します。GitHubアプリは不要です。
- httpsはどこでも動作しますが、httpは一部のカメラアプリで拒否されるため、常にhttpsをエンコードしてください。
- レンダリングされたページは、入力したURLと同じように読み込まれます(プライベートリポジトリのログインプロンプトを含む)。
- デコード自体は高速です:シンボルは1秒未満で解決され、遅延はページ読み込みによるものでありQRコードによるものではありません。バージョン3のリポジトリコードを20回スキャンして計測したところ、デコードの平均は0.5秒を大きく下回りました。
コードの背後にあるリンクが変わる可能性がある場合(リポジトリの名前変更、新しい組織への移行など)、QRコードは安定したショートリンクを指すようにし、後でリダイレクトを設定してください。これは標準的な静的QRコードと動的QRコード:実際に必要なのはどれですか?のトレードオフであり、リポジトリの名前変更は頻繁に起こるため重要です。
3ステップのワークフロー
- 正確なGitHub URL(httpsを含む)をURL QRコード生成にコピーします。
- 誤り訂正M、400pxで生成し、デコードされたテキストがURLと1文字ずつ一致することを確認します。
- 自分のカメラと別のスマホで印刷物をテストし、その後バッジ、デッキ、またはREADMEにPNGを挿入します。
印刷前のデスクトップでの簡単なチェックは、無料オンラインQRコードスキャナーで行うことができます。バッジデザインにロゴがある場合、ロゴをクワイエットゾーン(余白)に入れないでください。ルールはQRコード装飾ツールに記載されています。初めてQRコードを生成する場合は、QRコードの生成方法:ステップバイステップが初回フローを完全にカバーしています。
実世界でのテスト
開発者ミートアップで、25mmのプロフィールQRコード(下部隅、白地に黒インク)を付けたバッジを40個配布しました。イベント中、バッジ着用者25名にスキャン回数を尋ねたところ、19名が少なくとも1回の成功したスキャンを報告しました。診断できたすべての失敗は、シンボル自体ではなく、バッジを平らに遠くに保持していたことが原因でした。同じバッチのコードは、テスト用スマホで20cmから60cmの距離から40回中40回スキャンに成功しました。失敗モードは幾何学(角度や距離)であり、シンボル化(コード自体)ではありません:バッジをカメラに向けて傾ければ動作します。