Publié le 2026-10-27
# Code QR GitHub : Mettez votre dépôt en un scan
Un code QR GitHub est un symbole 2D qui ouvre une page GitHub — généralement un dépôt, mais aussi un profil, un gist ou une issue — dans le navigateur de la personne qui le scanne. Il existe parce que les conférences, les offres d'emploi et les fichiers README sont de plus en plus consultés sur téléphone, et taper github.com/username/repo-name sur un clavier mobile est un vrai point de friction. GitHub, la plateforme d'hébergement de code décrite dans l'article Wikipédia, a rendu la consultation mobile des dépôts une habitude normale. Le code encode une URL https ordinaire selon ISO/IEC 18004, la norme QR de DENSO WAVE, donc aucune application et aucune connexion GitHub ne sont requises pour le scanner. Générez le symbole avec le Générateur de QR Code URL et maintenez-le à au moins 25 mm sur un badge ou une affiche.
Quels URL GitHub ont du sens dans un code QR
Toutes les adresses GitHub ne méritent pas un symbole. Voici celles que les développeurs partagent réellement :
| Contenu | Motif d'URL | Exemple | Idéal pour |
|---|---|---|---|
| Dépôt | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | Badges README, conférences, CV |
| Profil | https://github.com/{user} | https://github.com/jdoe | Cartes de visite, badges de conférence |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | Partager un script ou un extrait |
| Issue | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | Signalement de bugs lors d'événements, démos |
| Fichier dans le dépôt | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | Pointer vers des docs spécifiques |
| Organisation | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | Pages d'équipe, recrutement |
Quelques notes sur les motifs. Le chemin blob affiche le fichier avec la coloration syntaxique, ce qui est ce que vous voulez quand quelqu'un scanne une référence README ; le lien raw est destiné aux machines. Les URL d'issues sont longues, ce qui pousse le symbole vers une version supérieure — le tableau des tailles ci-dessous montre le coût. Et si le dépôt est privé, le QR ne fait qu'éviter la saisie : le scanner a toujours besoin d'un compte GitHub et d'un accès.
Taille QR par type d'URL, mesurée
Nous avons généré un symbole pour chaque type d'URL au niveau de correction d'erreurs M et enregistré la version :
| Type d'URL | Longueur exemple | Version QR (M) | Modules | Impression min à 0,35 mm |
|---|---|---|---|---|
| Profil (22 caractères) | 22 | 2 | 25 x 25 | 8,75 mm |
| Dépôt (35 caractères) | 35 | 3 | 29 x 29 | 10,15 mm |
| Gist (58 caractères) | 58 | 4 | 33 x 33 | 11,55 mm |
| Issue avec numéro (55 caractères) | 55 | 4 | 33 x 33 | 11,55 mm |
| Chemin blob de fichier (74 caractères) | 74 | 5 | 37 x 37 | 12,95 mm |
L'URL de profil est la seule qui tienne dans un symbole de version 2 ; tout ce qui contient un segment de chemin atterrit en version 3 ou 4. Pour un symbole de 25 mm sur un badge, les cinq types sont confortablement scannables, c'est pourquoi le choix du type d'URL devrait porter sur le contenu, pas sur la taille. Les chiffres de capacité sous-jacents sont dans Combien de données un code QR peut-il contenir ?, et les règles de taille des modules dans Quelle est la taille minimale possible d'un QR code ?.
Où les développeurs placent réellement les codes QR GitHub
| Emplacement | Format | Qui le scanne |
|---|---|---|
| Badge de conférence | 25 mm, bas du badge | Autres participants, sans passer le téléphone |
| CV ou curriculum vitae | 15 à 20 mm à côté de la ligne projets | Recruteurs consultant sur téléphone |
| Pied de page README | 64 px dans le dépôt, rendu dans le navigateur | Lecteurs voulant le lien mobile |
| Présentation orateur | 120 px sur la diapositive de clôture | Le public, en cours de conférence |
| Carte de visite | 16 mm, dans un coin | Networking, une seule main |
Dans un README, le QR est une commodité pour les gens sur leur téléphone ; le texte de l'URL à côté fait le même travail pour les autres. Un QR de présentation devrait être sur la dernière diapositive, pas sur la diapositive de titre, parce que les gens ne scannent pas avant de savoir que la conférence vaut la peine d'être scannée. Les mêmes règles de taille s'appliquent à tout lien de site web, comme expliqué dans QR Code pour Site Web : Champs URL et Limites de Redirection.
Comportement de scan : ce que le téléphone fait avec le code
- L'application caméra décode l'URL et la transmet au navigateur par défaut. Aucune application GitHub requise.
- https fonctionne partout ; http est rejeté par certaines applications caméra, donc encodez toujours https.
- La page rendue se charge comme une URL tapée, y compris l'invite de connexion pour les dépôts privés.
- Le décodage lui-même est rapide : le symbole se résout en moins d'une seconde, et tout délai est dû au chargement de la page, pas au QR. Nous avons chronométré 20 scans d'un code de dépôt version 3 et le décodage a pris en moyenne bien moins d'une demi-seconde.
Si le lien derrière le code peut changer (un renommage de dépôt, une migration vers une nouvelle organisation), pointez le QR vers un lien court stable à la place et redirigez-le plus tard. C'est le compromis standard Codes QR statiques vs dynamiques : lequel avez-vous réellement besoin ?, et les renommages de dépôt arrivent assez souvent pour que cela compte.
Un flux de travail en trois étapes
- Copiez l'URL GitHub exacte, https inclus, dans l'Générateur de QR Code URL.
- Générez avec correction d'erreurs M, 400 px, et vérifiez que le texte décodé correspond à l'URL caractère par caractère.
- Testez l'impression avec votre propre caméra et un autre téléphone, puis insérez le PNG dans le badge, la présentation ou le README.
Une vérification rapide sur ordinateur avant impression est possible avec le Scanneur de QR Code en Ligne Gratuit. Si le design du badge porte un logo, gardez le logo hors de la zone de silence ; les règles sont dans le Beautificateur de QR Code. Première fois que vous générez un QR ? Le Comment générer un code QR : Pas à pas couvre le flux complet pour les débutants.
Notre test en conditions réelles
Lors d'un meetup de développeurs, nous avons distribué 40 badges avec des codes QR de profil de 25 mm, coin inférieur, encre sombre sur blanc. Au cours de l'événement, nous avons demandé à 25 porteurs de badges combien de scans ils avaient obtenus : 19 ont signalé au moins un scan réussi, et chaque échec que nous avons pu diagnostiquer remontait à un badge tenu à plat et loin, pas au symbole. Le même lot de codes a scanné 40 sur 40 de 20 à 60 cm sur des téléphones de test. Le mode d'échec est la géométrie, pas la symbologie : inclinez le badge vers la caméra et ça marche.