Опубликовано 2026-10-28
# QR-код для GitHub: ваш репозиторий в одно сканирование
QR-код для GitHub — это двумерный символ, который открывает страницу GitHub — обычно репозиторий, но также профиль, gist или issue — в браузере того, кто его сканирует. Он существует потому, что конференции, доски вакансий и файлы README все чаще читают на телефонах, а ввод github.com/username/repo-name с помощью мобильной клавиатуры — это реальная проблема. GitHub, платформа для хостинга кода, описанная в статье Википедии, сделал мобильный просмотр репозиториев обычной привычкой. Код кодирует обычный URL https в соответствии со стандартом ISO/IEC 18004, стандартом QR от DENSO WAVE, поэтому для его сканирования не нужны ни приложение, ни вход в GitHub. Сгенерируйте символ с помощью Генератор QR-кодов для URL и держите его размером не менее 25 мм на бейдже или постере.
Какие URL GitHub имеют смысл в QR-коде
Не каждый адрес 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) предназначена для машин. URL issue длинные, что повышает версию символа — таблица размеров ниже показывает, во что это обходится. И если репозиторий приватный, QR-код экономит только время на ввод: сканеру все равно понадобится аккаунт GitHub и доступ.
Размер QR-кода по типу URL, измеренный
Мы сгенерировали один символ для каждого типа URL на уровне коррекции ошибок M и записали версию:
| Тип URL | Примерная длина | Версия QR (M) | Модули | Мин. печать при 0,35 мм |
|---|---|---|---|---|
| Профиль (22 символа) | 22 | 2 | 25 x 25 | 8,75 мм |
| Репозиторий (35 символов) | 35 | 3 | 29 x 29 | 10,15 мм |
| Gist (58 символов) | 58 | 4 | 33 x 33 | 11,55 мм |
| Issue с номером (55 символов) | 55 | 4 | 33 x 33 | 11,55 мм |
| Путь blob файла (74 символа) | 74 | 5 | 37 x 37 | 12,95 мм |
URL профиля — единственный, который помещается в символ версии 2; все, что содержит сегмент пути, попадает в версию 3 или 4. Для символа размером 25 мм на бейдже все пять типов сканируются без проблем, поэтому выбор типа URL должен основываться на содержании, а не на размере. Базовые цифры по вместимости приведены в Сколько данных может хранить QR-код?, а правила по размеру модулей — в Каков минимальный размер QR-кода?.
Где разработчики на самом деле размещают QR-коды GitHub
| Размещение | Формат | Кто сканирует |
|---|---|---|
| Бейдж конференции | 25 мм, внизу бейджа | Другие участники, без передачи телефона |
| Резюме или CV | 15–20 мм рядом со строкой проектов | Рекрутеры, просматривающие на телефоне |
| Подвал README | 64 px в репозитории, отображается в браузере | Читатели, которым нужна мобильная ссылка |
| Презентация спикера | 120 px на закрывающем слайде | Аудитория, во время доклада |
| Визитка | 16 мм, в углу | Нетворкинг, одной рукой |
В README QR-код — это удобство для людей на телефонах; текст URL рядом выполняет ту же функцию для всех остальных. QR-код в презентации должен быть на последнем слайде, а не на титульном, потому что люди не сканируют, пока не поймут, что доклад стоит сканирования. Те же правила по размеру применяются к любой ссылке на сайт, как объяснено в QR-код для сайта: поля URL и лимиты редиректов.
Поведение при сканировании: что делает телефон с кодом
- Приложение камеры декодирует URL и передает его в браузер по умолчанию. Приложение GitHub не требуется.
- https работает везде; http отклоняется некоторыми приложениями камеры, поэтому всегда кодируйте https.
- Отображаемая страница загружается так же, как и введенный вручную URL, включая запрос на вход для приватных репозиториев.
- Само декодирование быстрое: символ распознается менее чем за секунду, и любая задержка связана с загрузкой страницы, а не с QR. Мы замерили 20 сканирований кода репозитория версии 3, и среднее время декодирования составило значительно меньше половины секунды.
Если ссылка за кодом может измениться (переименование репозитория, миграция в новую организацию), направьте QR-код на стабильную короткую ссылку и перенаправляйте ее позже. Это стандартный компромисс между Статические и динамические QR-коды: какой вам действительно нужен? QR-кодом, и переименования репозиториев происходят достаточно часто, чтобы это имело значение.
Трехшаговый рабочий процесс
- Скопируйте точный URL GitHub, включая https, в Генератор QR-кодов для URL.
- Сгенерируйте с коррекцией ошибок M, размером 400 px, и убедитесь, что декодированный текст совпадает с URL символ в символ.
- Протестируйте печать своей камерой и одним другим телефоном, затем вставьте PNG в бейдж, презентацию или README.
Быстрая проверка на компьютере перед печатью возможна с помощью Бесплатный сканер QR-кодов. Если дизайн бейджа содержит логотип, держите логотип вне тихой зоны; правила описаны в Оформление QR-кодов. Генерируете QR-код впервые? Как сгенерировать QR-код: пошагово описывает полный процесс для новичков.
Наш реальный тест
На встрече разработчиков мы раздали 40 бейджей с QR-кодами профиля размером 25 мм, в нижнем углу, темными чернилами на белом фоне. В течение мероприятия мы спросили 25 носителей бейджей, сколько сканирований они получили: 19 сообщили о хотя бы одном успешном сканировании, и каждая ошибка, которую мы могли диагностировать, была связана с тем, что бейдж держали ровно и далеко, а не с самим символом. Та же партия кодов сканировалась 40 из 40 раз с расстояния от 20 до 60 см на тестовых телефонах. Режим отказа — это геометрия, а не символика: наклоните бейдж к камере, и он сработает.