українська мова ▾ Topics ▾ Latest version ▾ git-switch last updated in 2.55.0

НАЗВА

git-switch  — Перемикання гілок

СИНОПСИС

git switch [<options>] [--no-guess] <branch>
git switch [<options>] --detach [<start-point>]
git switch [<options>] (-c|-C) <new-branch> [<start-point>]
git switch [<options>] --orphan <new-branch>

ОПИС

Перехід до вказаної гілки. Робоче дерево та індекс оновлюються відповідно до гілки. Усі нові коміти будуть додані у вершину цієї гілки.

За бажанням, нову гілку можна створити за допомогою -c, -C, автоматично з віддаленої гілки з такою ж назвою (див. --guess), або відʼєднати робоче дерево від будь-якої гілки за допомогою --detach, разом з перемиканням на неї.

Перемикання гілок не вимагає чистого індексу та робочого дерева (тобто немає відмінностей порівняно з HEAD). Однак операція переривається, якщо призводить до втрати локальних змін, якщо не вказано інше за допомогою --discard-changes або --merge.

ОПЦІЇ

<branch>

Гілка, на яку потрібно перейти.

<нова-гілка>

Назва для нової гілки.

<start-point>

Початкова точка для нової гілки. Вказівка <початкової-точки> дозволяє створити гілку на основі деякої іншої точки в історії, ніж та, на яку зараз вказує HEAD. (Або, у випадку --detach, дозволяє перевірити та почати від деякої іншої точки.)

Ви можете використовувати синтаксис @{-<N>}, щоб звернутися до <N>-ї останньої гілки/коміту, до якої було здійснено перехід за допомогою команди git switch або git checkout. Ви також можете вказати -, що є синонімом @{-1}. Це часто використовується для швидкого переходу між двома гілками або для скасування помилкового переходу на іншу гілку.

У особливому випадку можна використовувати <rev-a>...<rev-b> як скорочений запис для бази злиття <rev-a> та <rev-b>, якщо така база існує лише одна. Можна опустити не більше одного з елементів <rev-a> та <rev-b>; у цьому випадку буде використано значення HEAD.

-c <new-branch>
--create <new-branch>

Створіть нову гілку з назвою <new-branch>, починаючи з <start-point>, перш ніж перемикатися на гілку. Це транзакційний еквівалент

$ git branch <new-branch>
$ git switch <new-branch>

тобто, гілка не скидається/не створюється, доки команда git switch не буде успішною (наприклад, коли гілка використовується в іншому робочому дереві, не лише поточна гілка залишається незмінною, але й гілка не скидається до початкової точки).

-C <new-branch>
--force-create <new-branch>

Аналогічно до --create, за винятком того, що якщо гілка <new-branch> вже існує, її буде скинуто до точки <start-point>. Це зручний спосіб замість:

$ git branch -f _<new-branch>_
$ git switch _<new-branch>_
-d
--detach

Переключитись на коміт для перевірки та експериментів, які можна відкинути. Дивіться розділ "DETACHED HEAD" в git-checkout[1] для отримання детальної інформації.

--guess
--no-guess

Якщо <branch> не знайдено, але існує гілка відстеження саме в одному віддаленому репозиторії (назвемо його <remote>) з відповідною назвою, розглядайте це як еквівалент

$ git switch -c <branch> --track <remote>/<branch>

Якщо гілка існує на декількох віддалених репозиторіях і один із них вказано у конфігураційній змінній