Программирование
Поисковый справочник по репозиториям, branch, commit, синхронизации, PR, конфликтам и безопасным Git-действиям.
33 терминов
Основные понятия
Repository
engineerdoge/math-ai-toolsПапка проекта, отслеживаемая системой контроля версий Git, обычно зеркально отображаемая на GitHub.
Когда вы запрашиваете просмотр проекта, фиксацию изменений или сравнение веток, репозиторий является единицей, с которой выполняется работа.
engineerdoge/math-ai-toolsПроверьте текущий статус репозитория.
Основные понятия
Working tree
git statusФайлы, которые в настоящее время находятся в рабочей области на вашем компьютере, включая изменения, которые еще не были зафиксированы.
Используйте это для разделения истории коммитов от изменений, которые в настоящее время находятся в процессе выполнения.
git statusОтображать изменения в рабочей области.
Основные понятия
Staging area
git add src/components/SiteHeader.tsxВременный набор изменений, которые будут включены в следующий коммит.
Это позволяет коммитить только файлы или фрагменты, которые принадлежат друг другу.
Область подготовки сама по себе не сохраняет историю. Коммит - это то, что ее записывает.
git add src/components/SiteHeader.tsxДобавьте только файлы для страницы с терминами Git.
Основные понятия
Commit
git commit -m "Add Git terms reference"Сохраненный снимок выбранных изменений в истории репозитория.
Фиксации позволяют просматривать, сравнивать, развертывать или отменять изменения позже.
git commit -m "Add Git terms reference"Создайте коммит с кратким сообщением.
Основные понятия
Diff
git diffВид построчного представления изменений между двумя состояниями файла.
Diff – это самый быстрый способ проверить, какие изменения были внесены, прежде чем зафиксировать их.
git diffПросмотрите изменения (diff) для неожиданных изменений.
Ветки
Branch
qwen3.5Именованная линия работы, которая может перемещаться отдельно от других линий работы.
Ветки позволяют разрабатывать функцию, не изменяя сразу основную ветку.
qwen3.5Сообщите мне, в какой ветке я сейчас нахожусь.
Ветки
main branch
mainВетвь по умолчанию, которая обычно представляет стабильную или готовую к производству версию.
Сравните вашу рабочую ветку с основной веткой, чтобы увидеть, что изменилось.
mainСравните эту ветку с основной веткой.
Ветки
checkout
git switch qwen3.5Переключение рабочей ветки на другую ветку или коммит.
Используйте это, когда вам нужно просмотреть или продолжить работу над другой веткой.
Неизмененные изменения могут блокировать переключение веток, если они будут перезаписаны.
git switch qwen3.5Переключитесь на ветку qwen3.5 после проверки наличия незафиксированных изменений.
Ветки
merge
git merge mainОбъединение изменений из одной ветки в другую ветку.
Используйте merge для переноса основных обновлений в вашу ветку разработки или завершения реализации новой функции в основную ветку.
Слияние может вызывать конфликты, когда обе ветки редактировали одни и те же строки по-разному.
git merge mainОбъясните, что произойдет перед слиянием ветки main в эту ветку.
Ветки
rebase
git rebase mainПовторное применение изменений из одной ветки поверх другого базового коммита.
Это может сделать историю похожей на линейную перед слиянием ветки с функциями.
Rebase переписывает историю коммитов, поэтому его следует использовать с осторожностью в общих ветках.
git rebase mainНе выполняйте перебазировку сейчас. Сначала объясните риск на этой ветке.
Синхронизация
clone
git clone https://github.com/user/project.gitСоздание локальной копии удаленного репозитория.
Обычно это первый шаг при начале работы над существующим проектом на GitHub.
git clone https://github.com/user/project.gitКлонируйте этот репозиторий и покажите доступные ветки.
Синхронизация
remote
origin git@github.com:user/project.gitИменованное подключение от локального репозитория к репозиторию, расположенному в другом месте.
Удаленные настройки определяют, где происходят обмен данными между клиентом и сервером.
origin git@github.com:user/project.gitОтображать настроенные удаленные репозитории.
Синхронизация
fetch
git fetch originЗагрузка информации удаленной ветки без изменения ваших рабочих файлов.
Используйте `fetch` перед сравнением вашей ветки с последним состоянием удаленного репозитория.
git fetch originПолучить из исходного источника, затем сравнить эту ветку с основной.
Синхронизация
pull
git pull origin mainПолучение удаленных изменений и применение их к текущей ветке.
Используйте это для обновления вашей локальной ветки с изменениями, которые были отправлены в другое место.
Изменение ветки может изменить вашу рабочую ветку и вызвать конфликты.
git pull origin mainПеред загрузкой проверьте, есть ли у меня локальные необновленные изменения.
Синхронизация
push
git push origin qwen3.5Загрузка локальных коммитов в удаленный репозиторий.
`Push` делает ваши локальные изменения, зафиксированные в репозитории, доступными на GitHub или другом удаленном сервере.
`Push` загружает только зафиксированные изменения, а не не сохраненные изменения в рабочей области.
git push origin qwen3.5Выполните `push` текущей ветки после подтверждения успешной сборки.
Синхронизация
origin
git push origin qwen3.5Стандартное имя для удаленного репозитория, из которого вы клонировали.
Большинство примеров push, pull и fetch используют "origin" в качестве имени удаленного репозитория.
git push origin qwen3.5Проверьте, указывает ли источник на ожидаемый репозиторий GitHub.
Ревью
Pull Request
Открыть PR из qwen3.5 в основную ветку.Страница просмотра в GitHub для обсуждения и слияния изменений ветки.
Используйте PR для просмотра измененных файлов, выполнения проверок, обсуждения комментариев и безопасного слияния.
Открыть PR из qwen3.5 в основную ветку.Опишите, что должно быть включено в описание PR.
Ревью
Review
Просмотреть запрошенные измененияПроверка изменений в коде на наличие ошибок, регрессий, читаемости и отсутствующих тестов.
Проверка помогает выявить проблемы до слияния ветки в общую кодовую базу.
Просмотреть запрошенные измененияПроверьте эту ветку на наличие ошибок и отсутствующих тестов.
Конфликты
Merge conflict
CONFLICT (content): Конфликт слияния в src/app/page.tsxСитуация, когда Git не может автоматически объединить изменения из разных веток.
Вы должны выбрать правильный окончательный контент, прежде чем слияние сможет продолжиться.
Не принимайте слепо одну точку зрения. Сначала проверьте предполагаемое поведение.
CONFLICT (content): Конфликт слияния в src/app/page.tsxОбъясните конфликт и предложите наиболее безопасное решение.
Конфликты
Conflict marker
<<<<<<< HEADТекстовые маркеры, которые Git вставляет в файл, чтобы показать конфликтующие версии.
Маркеры показывают, какая часть пришла из вашей текущей ветки, а какая – из входящей ветки.
Маркеры конфликтов не должны оставаться в зафиксированном коде.
<<<<<<< HEADНайдите все оставшиеся маркеры конфликтов.
Конфликты
Untracked file
?? src/lib/git-github.tsФайл, который существует в папке, но еще не добавлен в отслеживание Git.
Новые страницы и компоненты обычно отображаются как не отслеживаемые, пока они не будут добавлены в индекс.
?? src/lib/git-github.tsПеречислите неотслеживаемые файлы и сообщите, какие из них относятся к этой функции.
Конфликты
Modified file
M src/components/SiteHeader.tsxОтслеживаемый файл, содержимое которого отличается от последней зафиксированной версии.
Это помогает вам увидеть, какие существующие файлы были изменены текущей работой.
M src/components/SiteHeader.tsxОтображать измененные файлы для этой задачи.
Безопасность
stash
git stash push -m "before branch switch"Временно сохраняет незафиксированные изменения, чтобы рабочая область стала чистой.
Используйте команду "stash" перед переключением веток, если вы еще не готовы зафиксировать изменения.
Сохраненные изменения могут быть забыты. Всегда давайте им четкое имя и применяйте их намеренно.
git stash push -m "before branch switch"Сохраните мои текущие изменения с четким сообщением перед переключением веток.
Безопасность
reset
git reset --soft HEAD~1Возврат ветки или промежуточной версии к другому коммиту или состоянию.
Мягкая или частичная перезапись может изменить локальный коммит перед его передачей.
Жесткая перезагрузка может привести к потере работы. Перед использованием запросите объяснение.
git reset --soft HEAD~1Объясните самый безопасный способ отменить последнюю локальную фиксацию без потери изменений.
Безопасность
revert
git revert abc1234Создание нового коммита, который отменяет предыдущий коммит.
Откат обычно безопаснее, чем перезапись истории после того, как изменения были отправлены.
git revert abc1234Отмените проблемный коммит, не перезаписывая общую историю.
Безопасность
force push
git push --force-with-lease origin qwen3.5Перезапись удаленной ветки историей вашей локальной ветки.
Иногда используется после перезаписи локальной истории в частной ветке с функциями.
Принудительная отправка может перезаписать удаленные коммиты других пользователей. Предпочтительнее использовать `force-with-lease` и сначала убедиться.
git push --force-with-lease origin qwen3.5Не используйте принудительную отправку. Объясните, необходима ли принудительная отправка с проверкой.
Безопасность
.gitignore
Директория .next/Файл, указывающий Git, какие файлы или папки не следует отслеживать.
Используйте это для выходных данных сборки, зависимостей, локальных файлов среды и временных файлов.
Директория .next/Проверьте, правильно ли игнорируется вывод сборки.
Команды
git status
git status --shortКоманда, которая показывает ветку, подготовленные изменения, измененные файлы и неотслеживаемые файлы.
Запустите его перед редактированием, коммитом, извлечением или переключением ветки.
git status --shortЗапустите git status и суммируйте только важные изменения.
Команды
git log
git log --oneline -5Команда для просмотра истории коммитов.
Используйте это для поиска последних изменений, сравнения работы или определения изменения для отката.
git log --oneline -5Отображать последние пять коммитов в компактном формате.
Команды
git add
git add src/lib/git-github.tsКоманда, которая подготавливает изменения для следующего коммита.
Используйте явные пути, когда вы хотите сделать сфокусированный коммит.
git add src/lib/git-github.tsДобавьте только файлы, созданные для этой страницы.
Команды
git commit
git commit -m "Add Git terms reference"Команда, которая записывает подготовленные изменения в историю репозитория.
Используйте сообщение, которое объясняет, что изменилось и почему это важно.
git commit -m "Add Git terms reference"Зафиксируйте внесенные изменения с четким сообщением.
Команды
git pull
git pull --ff-onlyКоманда, которая обновляет текущую ветку из удаленной ветки.
Опция --ff-only позволяет избежать создания неожиданного слияния.
git pull --ff-onlyИспользуйте `ff-only`, только если это безопасно.
Команды
git push
git push origin HEADКоманда, которая загружает локальные коммиты в удаленную ветку.
Используйте это после успешного прохождения тестов и готовности к публикации изменений.
git push origin HEADВыполните `push` этой ветки после подтверждения отсутствия ошибок линтинга или сборки.