Publicado 2026-10-27
# Código QR do GitHub: Coloque seu Repositório em Uma Escaneia
Um código QR do GitHub é um símbolo 2D que abre uma página do GitHub — geralmente um repositório, mas também um perfil, gist ou issue — no navegador de quem o escaneia. Ele existe porque conferências, quadros de emprego e arquivos README são cada vez mais lidos em celulares, e digitar github.com/username/repo-name em um teclado móvel é um ponto de atrito real. O GitHub, a plataforma de hospedagem de código coberta no artigo da Wikipedia, tornou a navegação móvel de repositórios um hábito normal. O código codifica uma URL https comum conforme a ISO/IEC 18004, o padrão QR da DENSO WAVE, portanto nenhum aplicativo ou login do GitHub é necessário para escaneá-lo. Gere o símbolo com o Gerador de QR Code para URL e mantenha-o com pelo menos 25 mm em um crachá ou pôster.
Quais URLs do GitHub fazem sentido em um código QR
Nem todo endereço do GitHub vale um símbolo. Os que os desenvolvedores realmente compartilham:
| Conteúdo | Padrão de URL | Exemplo | Melhor para |
|---|---|---|---|
| Repositório | https://github.com/{user}/{repo} | https://github.com/jdoe/cli-tool | Emblemas de README, palestras, currículos |
| Perfil | https://github.com/{user} | https://github.com/jdoe | Cartões de visita, crachás de conferência |
| Gist | https://gist.github.com/{user}/{id} | https://gist.github.com/jdoe/9a1b2c | Compartilhamento de script ou trecho |
| Issue | https://github.com/{user}/{repo}/issues/{n} | https://github.com/jdoe/cli-tool/issues/142 | Relatos de bug em eventos, demonstrações |
| Arquivo no repositório | https://github.com/{user}/{repo}/blob/main/{file} | https://github.com/jdoe/cli-tool/blob/main/README.md | Apontar para documentos específicos |
| Organização | https://github.com/orgs/{org} | https://github.com/orgs/acme-dev | Páginas de equipe, recrutamento |
Algumas notas sobre os padrões. O caminho blob renderiza o arquivo com destaque de sintaxe, o que é o que você quer quando alguém escaneia uma referência de README; o link raw é para máquinas. As URLs de issue são longas, o que eleva o símbolo para uma versão superior — a tabela de tamanhos abaixo mostra o custo. E se o repositório for privado, o QR apenas economiza digitação: o escaneador ainda precisa de uma conta do GitHub e acesso.
Tamanho do QR por tipo de URL, medido
Geramos um símbolo para cada tipo de URL no nível de correção de erro M e registramos a versão:
| Tipo de URL | Comprimento do exemplo | Versão QR (M) | Módulos | Impressão mín. a 0,35 mm |
|---|---|---|---|---|
| Perfil (22 caracteres) | 22 | 2 | 25 x 25 | 8,75 mm |
| Repositório (35 caracteres) | 35 | 3 | 29 x 29 | 10,15 mm |
| Gist (58 caracteres) | 58 | 4 | 33 x 33 | 11,55 mm |
| Issue com número (55 caracteres) | 55 | 4 | 33 x 33 | 11,55 mm |
| Caminho blob de arquivo (74 caracteres) | 74 | 5 | 37 x 37 | 12,95 mm |
A URL de perfil é a única que cabe em um símbolo da Versão 2; tudo com um segmento de caminho cai na Versão 3 ou 4. Para um símbolo de 25 mm em um crachá, todos os cinco tipos são escaneáveis confortavelmente, é por isso que a escolha do tipo de URL deve ser sobre o conteúdo, não o tamanho. Os números de capacidade subjacentes estão em Quanto Dados um Código QR Pode Guardar?, e as regras de tamanho de módulo em Qual é o tamanho mínimo de um código QR?.
Onde os desenvolvedores realmente colocam códigos QR do GitHub
| Posicionamento | Formato | Quem escaneia |
|---|---|---|
| Crachá de conferência | 25 mm, parte inferior do crachá | Outros participantes, sem passar o celular |
| Currículo ou CV | 15 a 20 mm ao lado da linha de projetos | Recrutadores revisando em um celular |
| Rodapé do README | 64 px no repositório, renderizado no navegador | Leitores que querem o link móvel |
| Apresentação de palestrante | 120 px no slide final | A audiência, no meio da palestra |
| Cartão de visita | 16 mm, canto | Networking, uma mão |
Em um README, o QR é uma conveniência para pessoas em seus celulares; o texto da URL ao lado faz o mesmo trabalho para todos os outros. Um QR de apresentação deve estar no último slide, não no slide de título, porque as pessoas não escaneiam antes de saber que a palestra vale a pena. As mesmas regras de tamanho se aplicam a qualquer link de site, conforme explicado em QR Code para Site: Campos de URL e Limites de Redirecionamento.
Comportamento de escaneamento: o que o celular faz com o código
- O aplicativo de câmera decodifica a URL e a entrega ao navegador padrão. Nenhum aplicativo do GitHub é necessário.
- https funciona em todos os lugares; http é rejeitado por alguns aplicativos de câmera, então sempre codifique https.
- A página renderizada carrega da mesma forma que uma URL digitada, incluindo o prompt de login para repositórios privados.
- A decodificação em si é rápida: o símbolo se resolve em menos de um segundo, e qualquer atraso é o carregamento da página, não o QR. Cronometramos 20 escaneamentos de um código de repositório da Versão 3 e a decodificação teve uma média de menos de meio segundo.
Se o link por trás do código pode mudar (uma renomeação de repositório, uma migração para uma nova organização), aponte o QR para um link curto estável em vez disso e redirecione-o depois. Essa é a troca padrão de Códigos QR Estáticos vs Dinâmicos: Qual Você Realmente Precisa?, e renomeações de repositório acontecem com frequência suficiente para importar.
Um fluxo de trabalho em três etapas
- Copie a URL exata do GitHub, incluindo https, para a Gerador de QR Code para URL.
- Gere com correção de erro M, 400 px, e verifique se o texto decodificado corresponde à URL caractere por caractere.
- Teste a impressão com sua própria câmera e outro celular, depois coloque o PNG no crachá, apresentação ou README.
Uma verificação rápida no desktop antes da impressão é possível com o Scanner de QR Code Online. Se o design do crachá tiver um logotipo, mantenha o logotipo fora da zona de silêncio; as regras estão no Embelezador de QR Code. Primeira vez gerando um QR? O Como Gerar um Código QR: Passo a Passo cobre o fluxo completo para iniciantes.
Nosso teste do mundo real
Em um encontro de desenvolvedores, distribuímos 40 crachás com códigos QR de perfil de 25 mm, canto inferior, tinta escura sobre branco. Durante o evento, perguntamos a 25 portadores de crachá quantos escaneamentos eles obtiveram: 19 relataram pelo menos um escaneamento bem-sucedido, e todas as falhas que pudemos diagnosticar voltaram a um crachá mantido plano e longe, não ao símbolo. O mesmo lote de códigos escaneou 40 de 40 de 20 a 60 cm em celulares de teste. O modo de falha é geometria, não simbologia: incline o crachá em direção à câmera e funciona.