Мое
November 6

Как опубликовать/обновить свой проект на GitHub

Вот пошаговый набор команд, который поможет вам опубликовать и/или обновить ваш локальный проект на GitHub с помощью терминала. 🚀


➕ Как добавить проект на GitHub

💻 1. Подготовка локального проекта

Сначала перейдите в корневую папку вашего проекта, если вы еще не там, и инициализируйте локальный Git-репозиторий.

Команда

Назначение

cd /путь/к/вашему/проекту

Переходит в директорию вашего проекта.

git init

Инициализирует новый локальный Git-репозиторий в текущей папке.

git status

Проверяет текущее состояние файлов (какие файлы не отслеживаются).

touch .gitignore

(Опционально) Создает файл, чтобы указать Git, какие файлы игнорировать (например, папки /node_modules, /dist .env и др.).


📦 2. Добавление и фиксация файлов (Commit)

Теперь нужно подготовить файлы к сохранению и сделать первый коммит (фиксацию).

Команда

Назначение

git add .

Добавляет все текущие файлы и изменения в зону стейджинга (подготовки к коммиту).

git commit -m "Initial commit"

Создает первый коммит (сохранение) с описательным сообщением.


🔗 3. Связывание с GitHub

Прежде чем выполнить эти команды, вам нужно создать пустой репозиторий на сайте GitHub (без файлов README, .gitignore или лицензии), чтобы получить его URL.

Команда

Назначение

git branch -M main

Переименовывает основную ветку в main (это стало стандартом вместо master).

git remote add origin https://github.com/ВАШ_НИК/ИМЯ_РЕПОЗИТОРИЯ.git

Связывает локальный репозиторий с удаленным репозиторием на GitHub. (Замените URL на свой.)

git push -u origin main

Отправляет (пушит) локальную ветку main в удаленный репозиторий (origin) и устанавливает ее как отслеживаемую (-u).

Примечание: При первом git push вам может потребоваться аутентификация. Если вы используете HTTPS, GitHub предложит вам ввести токен доступа (PAT) вместо пароля.

🔄 4. Последующие изменения

Последующие изменения и обновления проекта публикуются гораздо проще:

Команда

Назначение

git add .

Добавляет новые изменения.

git commit -m "Описание изменений"

Фиксирует изменения локально.

git push

Отправляет зафиксированные изменения на GitHub.

В итоге, для публикации нового проекта на GitHub вам обычно достаточно всего четырех основных шагов:

  1. git init
  2. git add . и git commit -m "Initial commit"
  3. git remote add origin [URL]
  4. git push -u origin main

🔄 Как обновить ваш проект на GitHub

Выполняйте эти команды по порядку из корневой папки вашего локального проекта.

1. Добавление и фиксация изменений

Сначала нужно добавить все измененные файлы в область подготовки и создать фиксацию (commit).

# 1. Проверьте изменения:
git status

# 2. Добавить все изменения (новые/измененные файлы)
git add .

# 3. Создать фиксацию с описанием
# Замените текст в кавычках на описание ваших изменений
git commit -m "Исправлена ошибка restart_all и обновлена документация"

2. Синхронизация с GitHub

Перед отправкой изменений нужно получить все, что было добавлено в репозиторий другими, чтобы избежать конфликтов.

# 4. Скачать и объединить удаленные изменения (если они есть) # Если возникнут конфликты, вам нужно будет вручную их разрешить, сохранить файл, # а затем выполнить git add . и git commit git pull origin main

  • (Если git pull прошел без конфликтов, переходите к шагу 5, если же вылезли ошибки..)

#Часто ошибка возникает из-зa ветки. Проверьте какую ветку заливаете: в команде pull:

git branch

  • Если вы хотите соответствовать современному стандарту и переименовать вашу локальную ветку master в main перед отправкой:

# 1. Переименовать локальную ветку git branch -M main # 2. Отправить переименованную ветку на GitHub (и создать удаленную) git push -u origin main

3. Отправка изменений

Теперь, когда ваш локальный репозиторий полностью синхронизирован и содержит вашу новую фиксацию, можно отправлять изменения на GitHub.

# 5. Отправить локальные фиксации на GitHub
git push origin main

Готово! Ваш репозиторий на GitHub обновлен.