Что получится
~/notes/ рабочий каталог
.git/ история, ветки, настройки репозитория — не трогаем руками
.gitignore что git не видит: .env, node_modules/, логи
README.md
github.com/example-user/notes удалённый репозиторий «origin», доступ по SSH-ключу
Настройка
Ставим git
Где Как Версия Ubuntu 24.04 sudo apt install git2.43 Ubuntu 26.04 sudo apt install git2.53 Windows Git for Windows с git-scm.com или winget install Git.Git2.55 на октябрь 2026 macOS xcode-select --installилиbrew install gitApple — отстаёт, Homebrew — свежий Установщик Git for Windows спрашивает про переводы строк. Ответ по умолчанию («Checkout Windows-style, commit Unix-style») включает
core.autocrlf=true— для скриптов, которые поедут на сервер, это ловушка («Переводы строк в .gitattributes»).git --version # git version 2.55.0.windows.5Представляемся
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 по блокам».Создаём репозиторий
mkdir ~/notes && cd ~/notes git init # Initialized empty Git repository in /home/me/notes/.git/Всё, что знает git об этом каталоге, — в
.git/. Без.gitистории нет: удалим его — файлы останутся, а история пропадёт.Первым делом — .gitignore
До первого
git addрешаем, что в репозиторий не попадёт никогда:# .gitignore .env *.key node_modules/ dist/ *.log .DS_Store Thumbs.db.gitignoreдействует только на файлы, которые git ещё не отслеживает. Попавший в коммит.envстрока в.gitignoreиз истории не уберёт («.gitignore и файл в репозитории»), а если там пароль — его придётся менять («Секрет в коммите»). Готовые списки под язык и фреймворк — github.com/github/gitignore.Первый коммит
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.mdUntracked— 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.md6f203cf— начало хэша коммита, по нему на коммит можно сослаться в любой команде.Ключ 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 («Отпечаток сервера»).Пустой репозиторий на 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без параметров.Ежедневный круг
git status # что изменилось git diff # построчно: что именно git add -p # в коммит — по кускам, с вопросом на каждый git commit -m "traefik: readTimeout 300s — обрывались загрузки больше минуты" git pushgit diffперед коммитом — последний шанс заметить, что в коммит едет лишнее: пароль, отладочная строка, чужой файл. Сообщение — что и зачем; «fix» и «правки» через месяц ничего не скажут («Git на каждый день»).Второй компьютер
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, пароль не спросят.