basforge

Ищем по названиям, тексту и разборам «Если не работает».

    EN

    Git с нуля: первый репозиторий и push на GitHub по SSH

    Ставим git, представляемся ему, создаём репозиторий с .gitignore, делаем первый коммит и отправляем его на GitHub по SSH-ключу. Потом — ежедневный круг: правка, status, diff, коммит, push. Понадобится ключ SSH («Ключи SSH») и аккаунт GitHub.

    Что получится

    ~/notes/                         рабочий каталог
      .git/                          история, ветки, настройки репозитория — не трогаем руками
      .gitignore                     что git не видит: .env, node_modules/, логи
      README.md
    github.com/example-user/notes      удалённый репозиторий «origin», доступ по SSH-ключу

    Настройка

    1. Ставим git

      Где Как Версия
      Ubuntu 24.04 sudo apt install git 2.43
      Ubuntu 26.04 sudo apt install git 2.53
      Windows Git for Windows с git-scm.com или winget install Git.Git 2.55 на октябрь 2026
      macOS xcode-select --install или brew install git Apple — отстаёт, Homebrew — свежий

      Установщик Git for Windows спрашивает про переводы строк. Ответ по умолчанию («Checkout Windows-style, commit Unix-style») включает core.autocrlf=true — для скриптов, которые поедут на сервер, это ловушка («Переводы строк в .gitattributes»).

      git --version
      # git version 2.55.0.windows.5
    2. Представляемся

      git config --global user.name "example-user"
      git config --global user.email "[email protected]"
      git config --global init.defaultBranch main

      Имя и почта попадают в каждый коммит и видны всем, кто видит репозиторий. Чтобы не светить личную почту, GitHub даёт адрес …@users.noreply.github.com: он — в настройках аккаунта, раздел «Emails», и коммиты с ним всё равно привязаны к аккаунту.

      init.defaultBranch main — без этой строки git 2.x называет первую ветку master и показывает подсказку на 13 строк; в git 3.0 по умолчанию станет main. Остальные настройки — «~/.gitconfig по блокам».

    3. Создаём репозиторий

      mkdir ~/notes && cd ~/notes
      git init
      # Initialized empty Git repository in /home/me/notes/.git/

      Всё, что знает git об этом каталоге, — в .git/. Без .git истории нет: удалим его — файлы останутся, а история пропадёт.

    4. Первым делом — .gitignore

      До первого git add решаем, что в репозиторий не попадёт никогда:

      # .gitignore
      .env
      *.key
      node_modules/
      dist/
      *.log
      .DS_Store
      Thumbs.db

      .gitignore действует только на файлы, которые git ещё не отслеживает. Попавший в коммит .env строка в .gitignore из истории не уберёт («.gitignore и файл в репозитории»), а если там пароль — его придётся менять («Секрет в коммите»). Готовые списки под язык и фреймворк — github.com/github/gitignore.

    5. Первый коммит

      echo "# Заметки" > README.md
      git status
      # On branch main
      #
      # No commits yet
      #
      # Untracked files:
      #   (use "git add <file>..." to include in what will be committed)
      # 	.gitignore
      # 	README.md

      Untracked — git видит файлы, но не следит за ними. Кладём в индекс и коммитим:

      git add .gitignore README.md
      git commit -m "README и .gitignore"
      # [main (root-commit) 6f203cf] README и .gitignore
      #  2 files changed, 9 insertions(+)
      #  create mode 100644 .gitignore
      #  create mode 100644 README.md

      6f203cf — начало хэша коммита, по нему на коммит можно сослаться в любой команде.

    6. Ключ SSH — в GitHub

      Ключ из «Ключи SSH» подойдёт. Открытую половину — ~/.ssh/id_ed25519.pub — добавляем в GitHub: Settings, SSH and GPG keys, New SSH key, тип Authentication Key. Проверяем без git:

      ssh -T [email protected]
      # Hi example-user! You've successfully authenticated, but GitHub does not provide shell access.

      При первом подключении ssh спросит про ключ github.com: отпечаток ED25519 — SHA256:+DiY3wvvV6TuJJhbpZisF/zLDA0zPMSvHdkr4UvCOqU, он опубликован в документации GitHub («Отпечаток сервера»).

    7. Пустой репозиторий на GitHub и push

      На GitHub создаём репозиторий notes — пустой: без README, .gitignore и лицензии. Иначе у него будет своя история, и первый push откажет (см. «Если не работает»). Адрес берём вида SSH, не HTTPS:

      git remote add origin [email protected]:example-user/notes.git
      git push -u origin main
      # To github.com:example-user/notes.git
      #  * [new branch]      main -> main
      # branch 'main' set up to track 'origin/main'.

      origin — имя удалённого репозитория по соглашению. -u связывает локальную main с origin/main: дальше хватает git push и git pull без параметров.

    8. Ежедневный круг

      git status                 # что изменилось
      git diff                   # построчно: что именно
      git add -p                 # в коммит — по кускам, с вопросом на каждый
      git commit -m "traefik: readTimeout 300s — обрывались загрузки больше минуты"
      git push

      git diff перед коммитом — последний шанс заметить, что в коммит едет лишнее: пароль, отладочная строка, чужой файл. Сообщение — что и зачем; «fix» и «правки» через месяц ничего не скажут («Git на каждый день»).

    9. Второй компьютер

      git clone [email protected]:example-user/notes.git
      cd notes
      git log --oneline -3
      # 6f203cf (HEAD -> main, origin/main) README и .gitignore

      Перед работой — git pull, после — git push. Забыли pull и успели закоммитить — «Ветки в git».

    Если не работает

    error: src refspec main does not match any

    Причина
    В репозитории ещё нет коммитов, или ветка называется master, а пушим main.
    Делаем
    git branch --show-current покажет имя; нет коммитов — сначала git commit. Переименовать — git branch -m main.

    fatal: refusing to merge unrelated histories

    Причина
    Репозиторий на GitHub создан с README или лицензией — у него своя история, не связанная с нашей.
    Делаем
    Один раз: git pull origin main --allow-unrelated-histories, разбираем конфликты, git push. В следующий раз создаём на GitHub пустой репозиторий.

    remote: Support for password authentication was removed on August 13, 2021.

    Причина
    Адрес репозитория — https://…, и git просит пароль от аккаунта, а GitHub его не принимает.
    Делаем
    Переходим на SSH: git remote set-url origin [email protected]:example-user/notes.git.

    error: remote origin already exists.

    Причина
    git remote add для имени, которое уже есть, — например, повторили команду с исправленным адресом.
    Делаем
    git remote set-url origin <адрес> и git remote -v для проверки.

    nothing added to commit but untracked files present

    Причина
    Файлы новые, и в индекс их не добавили: git commit коммитит только индекс.
    Делаем
    git add <файл> или git add ., проверяем git status, потом git commit.

    Как проверить

    Локальная ветка связана с GitHub и ничего не отстало:

    git status -sb
    # ## main...origin/main
    git remote -v
    # origin  [email protected]:example-user/notes.git (fetch)
    # origin  [email protected]:example-user/notes.git (push)

    ## main...origin/main без [ahead 1] и [behind 2] — у нас и на GitHub одно и то же. Адрес начинается с git@ — ходим по SSH, пароль не спросят.