CINXE.COM
Git - git-switch Documentation
<!DOCTYPE html> <html lang="fr"> <head> <script type="text/javascript"> const currentTheme = localStorage.getItem("theme") if (currentTheme) { const prefersDarkScheme = window.matchMedia("(prefers-color-scheme: dark)").matches if ((prefersDarkScheme && currentTheme === "light") || (!prefersDarkScheme && currentTheme === "dark")) { document.documentElement.dataset.theme = currentTheme } } </script> <meta charset='utf-8'> <meta content='IE=edge,chrome=1' http-equiv='X-UA-Compatible'> <meta name="viewport" content="width=device-width, initial-scale=1"> <title>Git - git-switch Documentation</title> <link href="/favicon.ico" rel='shortcut icon' type='image/x-icon'> <link rel="stylesheet" href="/application.min.css"> </head> <body id="documentation"> <div class="inner"> <header> <a id="logo" href="/"><img src="/images/logo@2x.png" width="110" height="46" alt="Git" class="no-filter" /></a> <span id="tagline"></span> <script type="text/javascript"> const taglines = [ "fast-version-control", "everything-is-local", "distributed-even-if-your-workflow-isnt", "local-branching-on-the-cheap", "distributed-is-the-new-centralized" ]; var tagline = taglines[Math.floor(Math.random() * taglines.length)]; document.getElementById('tagline').innerHTML = '--' + tagline; </script> <div id="search-container"> <form id="search" action="/search/results"> <input id="search-text" name="search" placeholder="Type / to search entire site…" autocomplete="off" type="text" /> </form> <div id="search-results"></div> </div> <img src="/images/dark-mode.svg" id="dark-mode-button" /> </header> </div> <div class="inner"> <div id="content-wrapper"> <div tabindex="1" class="sidebar-btn"></div> <aside class="sidebar" id="sidebar"> <nav> <ul> <li> <a href="/about">About</a> <ul> </ul> </li> <li> <a href="/doc" class="active">Documentation</a> <ul class="expanded"> <li> <a href="/docs" class="active">Reference</a> </li> <li> <a href="/book">Book</a> </li> <li> <a href="/videos">Videos</a> </li> <li> <a href="/doc/ext">External Links</a> </li> </ul> </li> <li> <a href="/downloads">Downloads</a> <ul > <li> <a href="/downloads/guis">GUI Clients</a> </li> <li> <a href="/downloads/logos">Logos</a> </li> </ul> </li> <li> <a href="/community">Community</a> </li> </ul> </nav> </aside> <div id="content"> <div id='reference-version'> <a class="dropdown-trigger" id="reference-languages-trigger" data-panel-id="l10n-versions-dropdown" href="#"> Français ▾</a> <div class='dropdown-panel right' id='l10n-versions-dropdown'> <header>Localized versions of <strong>git-switch</strong> manual</header> <ol class='reference-previous-versions'> <li> <a href="/docs/git-switch"><span class="version">English</span> </a> </li> <li> <a href="/docs/git-switch/fr"><span class="version">Français</span> </a> </li> <li> <a href="/docs/git-switch/pt_BR"><span class="version">Português (Brasil)</span> </a> </li> <li> <a href="/docs/git-switch/zh_HANS-CN"><span class="version">简体中文</span> </a> </li> </ol> <footer> Want to read in your language or fix typos?<br/> <a href="https://github.com/jnavila/git-manpages-l10n">You can help translate this page</a>. </footer> </div> <a class="dropdown-trigger" id="reference-topics-trigger" data-panel-id="topics-dropdown" href="#">Topics ▾</a> <div class='dropdown-panel right' id='topics-dropdown'> <div class='three-column'> <div class='column-left'> <h3 class='setup'>Setup and Config</h3> <ul class='unstyled'> <li> <a href="/docs/git/fr"> git </a> </li> <li> <a href="/docs/git-config/fr"> config </a> </li> <li> <a href="/docs/git-help/fr"> help </a> </li> <li> <a href="/docs/git-bugreport/fr"> bugreport </a> </li> <li> <a href="/doc/credential-helpers"> Credential helpers </a> </li> </ul> <h3 class='projects'>Getting and Creating Projects</h3> <ul class='unstyled'> <li> <a href="/docs/git-init/fr"> init </a> </li> <li> <a href="/docs/git-clone/fr"> clone </a> </li> </ul> <h3 class='snapshotting'>Basic Snapshotting</h3> <ul class='unstyled'> <li> <a href="/docs/git-add/fr"> add </a> </li> <li> <a href="/docs/git-status/fr"> status </a> </li> <li> <a href="/docs/git-diff/fr"> diff </a> </li> <li> <a href="/docs/git-commit/fr"> commit </a> </li> <li> <a href="/docs/git-notes/fr"> notes </a> </li> <li> <a href="/docs/git-restore/fr"> restore </a> </li> <li> <a href="/docs/git-reset/fr"> reset </a> </li> <li> <a href="/docs/git-rm/fr"> rm </a> </li> <li> <a href="/docs/git-mv/fr"> mv </a> </li> </ul> <h3 class='branching'>Branching and Merging</h3> <ul class='unstyled'> <li> <a href="/docs/git-branch/fr"> branch </a> </li> <li> <a href="/docs/git-checkout/fr"> checkout </a> </li> <li> <a href="/docs/git-switch/fr"> switch </a> </li> <li> <a href="/docs/git-merge/fr"> merge </a> </li> <li> <a href="/docs/git-mergetool/fr"> mergetool </a> </li> <li> <a href="/docs/git-log/fr"> log </a> </li> <li> <a href="/docs/git-stash/fr"> stash </a> </li> <li> <a href="/docs/git-tag/fr"> tag </a> </li> <li> <a href="/docs/git-worktree/fr"> worktree </a> </li> </ul> <h3 class='sharing'>Sharing and Updating Projects</h3> <ul class='unstyled'> <li> <a href="/docs/git-fetch/fr"> fetch </a> </li> <li> <a href="/docs/git-pull/fr"> pull </a> </li> <li> <a href="/docs/git-push/fr"> push </a> </li> <li> <a href="/docs/git-remote/fr"> remote </a> </li> <li> <a href="/docs/git-submodule/fr"> submodule </a> </li> </ul> </div> <div class='column-middle'> <h3 class='inspection'>Inspection and Comparison</h3> <ul class='unstyled'> <li> <a href="/docs/git-show/fr"> show </a> </li> <li> <a href="/docs/git-log/fr"> log </a> </li> <li> <a href="/docs/git-diff/fr"> diff </a> </li> <li> <a href="/docs/git-difftool/fr"> difftool </a> </li> <li> <a href="/docs/git-range-diff/fr"> range-diff </a> </li> <li> <a href="/docs/git-shortlog/fr"> shortlog </a> </li> <li> <a href="/docs/git-describe/fr"> describe </a> </li> </ul> <h3 class='patching'>Patching</h3> <ul class='unstyled'> <li> <a href="/docs/git-apply/fr"> apply </a> </li> <li> <a href="/docs/git-cherry-pick/fr"> cherry-pick </a> </li> <li> <a href="/docs/git-diff/fr"> diff </a> </li> <li> <a href="/docs/git-rebase/fr"> rebase </a> </li> <li> <a href="/docs/git-revert/fr"> revert </a> </li> </ul> <h3 class='debugging'>Debugging</h3> <ul class='unstyled'> <li> <a href="/docs/git-bisect/fr"> bisect </a> </li> <li> <a href="/docs/git-blame/fr"> blame </a> </li> <li> <a href="/docs/git-grep/fr"> grep </a> </li> </ul> <h3 class='email'>Email</h3> <ul class='unstyled'> <li> <a href="/docs/git-am/fr"> am </a> </li> <li> <a href="/docs/git-apply/fr"> apply </a> </li> <li> <a href="/docs/git-format-patch/fr"> format-patch </a> </li> <li> <a href="/docs/git-send-email"> send-email </a> </li> <li> <a href="/docs/git-request-pull/fr"> request-pull </a> </li> </ul> <h3 class='external'>External Systems</h3> <ul class='unstyled'> <li> <a href="/docs/git-svn"> svn </a> </li> <li> <a href="/docs/git-fast-import/fr"> fast-import </a> </li> </ul> <h3 class='server-admin'>Server Admin</h3> <ul class='unstyled'> <li> <a href="/docs/git-daemon/fr"> daemon </a> </li> <li> <a href="/docs/git-update-server-info"> update-server-info </a> </li> </ul> </div> <div class='column-right'> <h3 class='guides'>Guides</h3> <ul class='unstyled'> <li> <a href="/docs/gitattributes"> gitattributes </a> </li> <li> <a href="/docs/gitcli"> Command-line interface conventions </a> </li> <li> <a href="/docs/giteveryday"> Everyday Git </a> </li> <li> <a href="/docs/gitfaq"> Frequently Asked Questions (FAQ) </a> </li> <li> <a href="/docs/gitglossary/fr"> Glossary </a> </li> <li> <a href="/docs/githooks"> Hooks </a> </li> <li> <a href="/docs/gitignore/fr"> gitignore </a> </li> <li> <a href="/docs/gitmodules"> gitmodules </a> </li> <li> <a href="/docs/gitrevisions"> Revisions </a> </li> <li> <a href="/docs/gitsubmodules"> Submodules </a> </li> <li> <a href="/docs/gittutorial"> Tutorial </a> </li> <li> <a href="/docs/gitworkflows"> Workflows </a> </li> <li> <a href="/docs/git#_guides"> All guides... </a> </li> </ul> <h3 class='admin'>Administration</h3> <ul class='unstyled'> <li> <a href="/docs/git-clean/fr"> clean </a> </li> <li> <a href="/docs/git-gc/fr"> gc </a> </li> <li> <a href="/docs/git-fsck/fr"> fsck </a> </li> <li> <a href="/docs/git-reflog/fr"> reflog </a> </li> <li> <a href="/docs/git-filter-branch"> filter-branch </a> </li> <li> <a href="/docs/git-instaweb/fr"> instaweb </a> </li> <li> <a href="/docs/git-archive/fr"> archive </a> </li> <li> <a href="/docs/git-bundle/fr"> bundle </a> </li> </ul> <h3 class='plumbing'>Plumbing Commands</h3> <ul class='unstyled'> <li> <a href="/docs/git-cat-file/fr"> cat-file </a> </li> <li> <a href="/docs/git-check-ignore/fr"> check-ignore </a> </li> <li> <a href="/docs/git-checkout-index/fr"> checkout-index </a> </li> <li> <a href="/docs/git-commit-tree/fr"> commit-tree </a> </li> <li> <a href="/docs/git-count-objects/fr"> count-objects </a> </li> <li> <a href="/docs/git-diff-index"> diff-index </a> </li> <li> <a href="/docs/git-for-each-ref"> for-each-ref </a> </li> <li> <a href="/docs/git-hash-object"> hash-object </a> </li> <li> <a href="/docs/git-ls-files"> ls-files </a> </li> <li> <a href="/docs/git-ls-tree"> ls-tree </a> </li> <li> <a href="/docs/git-merge-base"> merge-base </a> </li> <li> <a href="/docs/git-read-tree"> read-tree </a> </li> <li> <a href="/docs/git-rev-list/fr"> rev-list </a> </li> <li> <a href="/docs/git-rev-parse"> rev-parse </a> </li> <li> <a href="/docs/git-show-ref"> show-ref </a> </li> <li> <a href="/docs/git-symbolic-ref"> symbolic-ref </a> </li> <li> <a href="/docs/git-update-index"> update-index </a> </li> <li> <a href="/docs/git-update-ref"> update-ref </a> </li> <li> <a href="/docs/git-verify-pack"> verify-pack </a> </li> <li> <a href="/docs/git-write-tree"> write-tree </a> </li> </ul> </div> </div> </div> <a class="dropdown-trigger" id="reference-versions-trigger" data-panel-id="previous-versions-dropdown" href="#"> Latest version ▾ </a> <span class="light d-flex">git-switch last updated in 2.44.0</span> <div class='dropdown-panel left' id='previous-versions-dropdown'> <header>Changes in the <strong>git-switch</strong> manual</header> <ol class='reference-previous-versions'> <li class="no-change"><span>2.44.1 → 2.49.0 no changes</span></li> <li> <a href="/docs/git-switch/2.44.0"><span class="version">2.44.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2024-02-23</em> </a> </li> <li class="no-change"><span>2.43.2 → 2.43.6 no changes</span></li> <li> <a href="/docs/git-switch/2.43.1"><span class="version">2.43.1</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2024-02-09</em> </a> </li> <li> <a href="/docs/git-switch/2.43.0"><span class="version">2.43.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2023-11-20</em> </a> </li> <li class="no-change"><span>2.38.1 → 2.42.4 no changes</span></li> <li> <a href="/docs/git-switch/2.38.0"><span class="version">2.38.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2022-10-02</em> </a> </li> <li class="no-change"><span>2.35.1 → 2.37.7 no changes</span></li> <li> <a href="/docs/git-switch/2.35.0"><span class="version">2.35.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2022-01-24</em> </a> </li> <li class="no-change"><span>2.30.1 → 2.34.8 no changes</span></li> <li> <a href="/docs/git-switch/2.30.0"><span class="version">2.30.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2020-12-27</em> </a> </li> <li class="no-change"><span>2.27.1 → 2.29.3 no changes</span></li> <li> <a href="/docs/git-switch/2.27.0"><span class="version">2.27.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2020-06-01</em> </a> </li> <li class="no-change"><span>2.23.1 → 2.26.3 no changes</span></li> <li> <a href="/docs/git-switch/2.23.0"><span class="version">2.23.0</span> <span class="diff"> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/green-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/red-dot.png" /> <img src="/images/icons/grey-dot.png" /> <img src="/images/icons/grey-dot.png" /> </span> <em class="date">2019-08-16</em> </a> </li> <li> </li> </ol> <footer> <p>Check your version of git by running</p> <code class="command">git --version</code> </footer> </div> </div> <div id="main" data-pagefind-filter="category:reference" data-pagefind-meta="category:Reference" data-pagefind-weight="0.05" data-pagefind-body> <div class="sect1"> <h2 id="_nom"><a class="anchor" href="#_nom"></a>NOM</h2> <div class="sectionbody"> <div class="paragraph"> <p>git-switch - bascule de branche</p> </div> </div> </div> <div class="sect1"> <h2 id="_synopsis"><a class="anchor" href="#_synopsis"></a>SYNOPSIS</h2> <div class="sectionbody"> <div class="verseblock"> <pre class="content"><em>git switch</em> [<options>] [--no-guess] <branche> <em>git switch</em> [<options>] --detach [<point-de-départ>] <em>git switch</em> [<options>] (-c|-C) <nouvelle-branche> [<point-de-départ>] <em>git switch</em> [<options>] --orphan <nouvelle-branche></pre> </div> </div> </div> <div class="sect1"> <h2 id="_description"><a class="anchor" href="#_description"></a>DESCRIPTION</h2> <div class="sectionbody"> <div class="paragraph"> <p>Passe à une branche spécifiée. L’arbre de travail et l’index sont mis à jour pour correspondre à la branche. Tous les nouveaux commits seront ajoutés au sommet de cette branche.</p> </div> <div class="paragraph"> <p>En option, une nouvelle branche peut être créée avec les options <code>-c</code>, <code>-C</code>, automatiquement à partir d’une branche distante du même nom (voir <code>--guess</code>), ou détacher l’arbre de travail de toute branche avec <code>--detach</code> en même temps que la commutation.</p> </div> <div class="paragraph"> <p>La commutation de branche ne nécessite pas d’index et d’arbre de travail propres(c.-à-d. aucune différence par rapport à <code>HEAD</code>). L’opération est interrompue cependant si l’opération entraîne une perte de modifications locales, sauf indication contraire via <code>--discard-changes</code> ou <code>--merge</code>.</p> </div> <div class="paragraph"> <p>CETTE COMMANDE EST EXPÉRIMENTALE. LE COMPORTEMENT PEUT CHANGER.</p> </div> </div> </div> <div class="sect1"> <h2 id="_options"><a class="anchor" href="#_options"></a>OPTIONS</h2> <div class="sectionbody"> <div class="dlist"> <dl> <dt class="hdlist1" id="git-switch-ltbranchegt"> <a class="anchor" href="#git-switch-ltbranchegt"></a><branche> </dt> <dd> <p>Branche sur laquelle commuter.</p> </dd> <dt class="hdlist1" id="git-switch-ltnouvelle-branchegt"> <a class="anchor" href="#git-switch-ltnouvelle-branchegt"></a><nouvelle-branche> </dt> <dd> <p>Nom pour une nouvelle branche.</p> </dd> <dt class="hdlist1" id="git-switch-ltpointdedpartgt"> <a class="anchor" href="#git-switch-ltpointdedpartgt"></a><point_de_départ> </dt> <dd> <p>The starting point for the new branch. Specifying a <code><start-point></code> allows you to create a branch based on some other point in history than where HEAD currently points. (Or, in the case of <code>--detach</code>, allows you to inspect and detach from some other point.)</p> <div class="paragraph"> <p>Vous pouvez utiliser la syntaxe <code>@{-N}</code> pour faire référence à la N-ième dernière branche ou commit sur lesquels on a basculé en utilisant une opération « git switch » ou « git checkout ». Vous pouvez aussi spécifier <code>-</code> qui est synonyme de <code>@{-1}</code>. C’est souvent utilisé pour basculer rapidement entre deux branches ou pour annuler un basculement par erreur.</p> </div> <div class="paragraph"> <p>Autre cas spécial supplémentaire, vous pouvez utiliser <code>A...B</code> comme raccourci pour la base de fusion de <code>A</code> et <code>B</code> s’il y a exactement une seule base de fusion. Vous pouvez ne pas spécifier <code>A</code> ou <code>B</code>, auquel cas ce sera <code>HEAD</code> par défaut.</p> </div> </dd> <dt class="hdlist1" id="git-switch--cltnouvelle-branchegt"> <a class="anchor" href="#git-switch--cltnouvelle-branchegt"></a>-c <nouvelle-branche> </dt> <dt class="hdlist1" id="git-switch---createltnouvelle-branchegt"> <a class="anchor" href="#git-switch---createltnouvelle-branchegt"></a>--create <nouvelle-branche> </dt> <dd> <p>Créer une nouvelle branche nommée <code><nouvelle-branche></code> commençant à <code><point-de-départ></code> avant de basculer sur cette branche. C’est l’équivalent transactionnel de</p> <div class="listingblock"> <div class="content"> <pre>$ git branch <nouvelle-branche> $ git switch <nouvelle-branche></pre> </div> </div> <div class="paragraph"> <p>that is to say, the branch is not reset/created unless "git switch" is successful (e.g., when the branch is in use in another worktree, not just the current branch stays the same, but the branch is not reset to the start-point, either).</p> </div> </dd> <dt class="hdlist1" id="git-switch--Cltnouvelle-branchegt"> <a class="anchor" href="#git-switch--Cltnouvelle-branchegt"></a>-C <nouvelle-branche> </dt> <dt class="hdlist1" id="git-switch---force-createltnouvelle-branchegt"> <a class="anchor" href="#git-switch---force-createltnouvelle-branchegt"></a>--force-create <nouvelle-branche> </dt> <dd> <p>Similar to <code>--create</code> except that if <code><new-branch></code> already exists, it will be reset to <code><start-point></code>. This is a convenient shortcut for:</p> <div class="listingblock"> <div class="content"> <pre>$ git branch -f <nouvelle-branche> $ git switch <nouvelle-branche></pre> </div> </div> </dd> <dt class="hdlist1" id="git-switch--d"> <a class="anchor" href="#git-switch--d"></a>-d </dt> <dt class="hdlist1" id="git-switch---detach"> <a class="anchor" href="#git-switch---detach"></a>--detach </dt> <dd> <p>Switch to a commit for inspection and discardable experiments. See the "DETACHED HEAD" section in <a href='/docs/git-checkout/fr'>git-checkout[1]</a> for details.</p> </dd> <dt class="hdlist1" id="git-switch---guess"> <a class="anchor" href="#git-switch---guess"></a>--guess </dt> <dt class="hdlist1" id="git-switch---no-guess"> <a class="anchor" href="#git-switch---no-guess"></a>--no-guess </dt> <dd> <p>Si la <code><branche></code> n’est pas trouvée mais qu’il existe une branche de suivi pour un dépôt distant unique (appelé <code><distant></code>) avec un nom correspondant, le traiter comme équivalent à</p> <div class="listingblock"> <div class="content"> <pre>$ git switch -c <branche> --track <distant>/<branche></pre> </div> </div> <div class="paragraph"> <p>Si la branche existe dans plus d’un distant et que l’un d’entre eux est la valeur de la variable de configuration <code>checkout.defaultRemote</code>, celui-ci sera utilisé pour désambiguïser, même si la <branche> n’est pas unique parmi tous les distants. Réglez la variable <code>checkout.defaultRemote=origin</code> par exemple pour extraire toujours les branches distantes depuis celle-ci si <branche> est ambigüe mais existe sur le distant <em>origin</em>. Voir aussi <code>checkout.defaultRemote</code> dans <a href='/docs/git-config/fr'>git-config[1]</a>.</p> </div> <div class="paragraph"> <p><code>--guess</code> est le comportement par défaut. Utilisez <code>--no-guess</code> pour le désactiver.</p> </div> <div class="paragraph"> <p>Le comportement par défaut peut être défini via la variable de configuration <code>checkout.guess</code>.</p> </div> </dd> <dt class="hdlist1" id="git-switch--f"> <a class="anchor" href="#git-switch--f"></a>-f </dt> <dt class="hdlist1" id="git-switch---force"> <a class="anchor" href="#git-switch---force"></a>--force </dt> <dd> <p>An alias for <code>--discard-changes</code>.</p> </dd> <dt class="hdlist1" id="git-switch---discard-changes"> <a class="anchor" href="#git-switch---discard-changes"></a>--discard-changes </dt> <dd> <p>Proceed even if the index or the working tree differs from <code>HEAD</code>. Both the index and working tree are restored to match the switching target. If <code>--recurse-submodules</code> is specified, submodule content is also restored to match the switching target. This is used to throw away local changes.</p> </dd> <dt class="hdlist1" id="git-switch--m"> <a class="anchor" href="#git-switch--m"></a>-m </dt> <dt class="hdlist1" id="git-switch---merge"> <a class="anchor" href="#git-switch---merge"></a>--merge </dt> <dd> <p>Si vous avez des modifications locales sur un fichier ou plus qui sont différentes entre la branche actuelle et celle sur laquelle vous basculez, la commande refuse le basculement pour préserver vos modifications dans leur contexte. Cependant, avec cette option, une fusion à trois points entre la branche actuelle, le contenu de votre arbre de travail et la nouvelle branche est opérée et vous serez sur la nouvelle branche.</p> <div class="paragraph"> <p>Quand un conflit de fusion apparaît, les entrées d’index pour les chemins en conflit sont laissées non-fusionnées et vous devez résoudre les conflits et les marquer résolus pour les chemins concernés avec <code>git add</code> (ou <code>git rm</code> si la fusion doit aboutir à la suppression du chemin).</p> </div> </dd> <dt class="hdlist1" id="git-switch---conflictltstylegt"> <a class="anchor" href="#git-switch---conflictltstylegt"></a>--conflict=<style> </dt> <dd> <p>Identique à l’option <code>--merge</code> ci-dessus, mais la manière dont les sections en conflits sont présentées est modifiée, en surchargeant la variable de configuration <code>merge.conflictStyle</code>. Les valeurs possibles sont <code>merge</code> (fusion, par défaut), <code>diff3</code> et <code>zdiff3</code>.</p> </dd> <dt class="hdlist1" id="git-switch--q"> <a class="anchor" href="#git-switch--q"></a>-q </dt> <dt class="hdlist1" id="git-switch---quiet"> <a class="anchor" href="#git-switch---quiet"></a>--quiet </dt> <dd> <p>Silencieux, supprimer les messages d’état.</p> </dd> <dt class="hdlist1" id="git-switch---progress"> <a class="anchor" href="#git-switch---progress"></a>--progress </dt> <dt class="hdlist1" id="git-switch---no-progress"> <a class="anchor" href="#git-switch---no-progress"></a>--no-progress </dt> <dd> <p>L’état d’avancement est affiché sur la sortie standard d’erreur par défaut quand elle est attachée à un terminal, à moins que <code>--quiet</code> ne soit spécifié. Cette bascule active l’état d’avancement même sans être attaché à un terminal, indépendamment de <code>--quiet</code>.</p> </dd> <dt class="hdlist1" id="git-switch--t"> <a class="anchor" href="#git-switch--t"></a>-t </dt> <dt class="hdlist1" id="git-switch---trackdirectinherit"> <a class="anchor" href="#git-switch---trackdirectinherit"></a>--track [direct|inherit] </dt> <dd> <p>À la création d’une nouvelle branche, établir la configuration <em>upstream</em> (branche amont). <code>-c</code> est implicite. Voir <code>--track</code> dans <a href='/docs/git-branch/fr'>git-branch[1]</a> pour plus de détails.</p> <div class="paragraph"> <p>Si aucune option <code>-c</code> n’est fournie, le nom de la nouvelle branche sera dérivé de la branche de suivi à distance, en regardant la partie locale de la spécification de référence configurée pour le distant correspondant et en enlevant la partie initiale jusqu’au "*". Cela indiquerait d’utiliser le nom <code>hack</code> comme branche locale créée à partir de <code>origin/hack</code> (ou <code>remotes/origin/hack</code>, ou même <code>refs/remotes/origin/hack</code>). Si le nom fourni ne contient pas de barre oblique, ou si le résultat de la dérivation est un nom vide, la dérivation échoue. Vous pouvez spécifier explicitement un nom avec <code>-c</code> dans ce cas.</p> </div> </dd> <dt class="hdlist1" id="git-switch---no-track"> <a class="anchor" href="#git-switch---no-track"></a>--no-track </dt> <dd> <p>Ne pas renseigner la configuration « amont », même si la configuration <code>branch.autoSetupMerge</code> est true.</p> </dd> <dt class="hdlist1" id="git-switch---orphanltnouvelle-branchegt"> <a class="anchor" href="#git-switch---orphanltnouvelle-branchegt"></a>--orphan <nouvelle-branche> </dt> <dd> <p>Create a new unborn branch, named <code><new-branch></code>. All tracked files are removed.</p> </dd> <dt class="hdlist1" id="git-switch---ignore-other-worktrees"> <a class="anchor" href="#git-switch---ignore-other-worktrees"></a>--ignore-other-worktrees </dt> <dd> <p><code>git switch</code> échoue quand la référence voulue est déjà extraite dans un autre arbre de travail. Cette option force l’extraction. En d’autres termes, la réf peut être tenue par plus d’un arbre de travail.</p> </dd> <dt class="hdlist1" id="git-switch---recurse-submodules"> <a class="anchor" href="#git-switch---recurse-submodules"></a>--recurse-submodules </dt> <dt class="hdlist1" id="git-switch---no-recurse-submodules"> <a class="anchor" href="#git-switch---no-recurse-submodules"></a>--no-recurse-submodules </dt> <dd> <p>L’utilisation de <code>--recurse-submodules</code> permet de mettre à jour le contenu de tous les sous-modules actifs en fonction du commit enregistré dans le super-projet. Si l’option n’est pas spécifiée (ou si <code>--no-recurse-submodules</code> est spécifié), les arbres de travail des sous-modules ne sont pas mis à jour. Comme <a href='/docs/git-submodule/fr'>git-submodule[1]</a>, les <code>HEAD</code> des sous-modules seront détachées.</p> </dd> </dl> </div> </div> </div> <div class="sect1"> <h2 id="_exemples"><a class="anchor" href="#_exemples"></a>EXEMPLES</h2> <div class="sectionbody"> <div class="paragraph"> <p>The following command switches to the "master" branch:</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch master</pre> </div> </div> <div class="paragraph"> <p>Après avoir travaillé dans la mauvaise branche, basculer sur la branche correcte serait réalisé par :</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch monsujet</pre> </div> </div> <div class="paragraph"> <p>Cependant, votre « fausse » branche et votre branche correcte « monsujet » peuvent être différentes par les fichiers que vous avez modifiés localement, auquel cas le basculement ci-dessus échouerait comme ceci :</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch monsujet error : Vos modifications locales aux fichiers suivants seraient écrasées par l'extraction :</pre> </div> </div> <div class="paragraph"> <p>Vous pouvez fournir l’option <code>-m</code> à la commande, ce qui essaierait une fusion à trois points :</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch -m monsujet Fusion automatique de frotz</pre> </div> </div> <div class="paragraph"> <p>Après cette fusion à trois points, les modifications locales ne sont <em>pas</em> enregistrées dans votre index, donc <code>git diff</code> vous montrerait ce qui a changé depuis le sommet de la nouvelle branche.</p> </div> <div class="paragraph"> <p>To switch back to the previous branch before we switched to mytopic (i.e. "master" branch):</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch -</pre> </div> </div> <div class="paragraph"> <p>You can grow a new branch from any commit. For example, switch to "HEAD~3" and create branch "fixup":</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch -c fixup HEAD~3 Switched to a new branch 'fixup'</pre> </div> </div> <div class="paragraph"> <p>Si vous souhaitez démarrer une branche nouvelle depuis une branche distante du même nom :</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch new-topic Branch 'new-topic' set up to track remote branch 'new-topic' from 'origin' Switched to a new branch 'new-topic'</pre> </div> </div> <div class="paragraph"> <p>To check out commit <code>HEAD~3</code> for temporary inspection or experiment without creating a new branch:</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch --detach HEAD~3 HEAD is now at 9fc9555312 Merge branch 'cc/shared-index-permbits'</pre> </div> </div> <div class="paragraph"> <p>If it turns out whatever you have done is worth keeping, you can always create a new name for it (without switching away):</p> </div> <div class="listingblock"> <div class="content"> <pre>$ git switch -c good-surprises</pre> </div> </div> </div> </div> <div class="sect1"> <h2 id="_configuration"><a class="anchor" href="#_configuration"></a>CONFIGURATION</h2> <div class="sectionbody"> <div class="paragraph"> <p>Tout ce qui se trouve en dessous de cette ligne dans cette section est inclus de manière sélective à partir de la documentation <a href='/docs/git-config/fr'>git-config[1]</a>. Le contenu est le même que celui qui s’y trouve :</p> </div> <div class="admonitionblock warning"> <table> <tr> <td class="icon"> <div class="title">Warning</div> </td> <td class="content"> <div class="paragraph"> <p>Missing <code>fr/config/checkout.adoc</code></p> </div> <div class="paragraph"> <p>See original version for this content.</p> </div> </td> </tr> </table> </div> </div> </div> <div class="sect1"> <h2 id="_voir_aussi"><a class="anchor" href="#_voir_aussi"></a>VOIR AUSSI</h2> <div class="sectionbody"> <div class="paragraph"> <p><a href='/docs/git-checkout/fr'>git-checkout[1]</a>, <a href='/docs/git-branch/fr'>git-branch[1]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_git"><a class="anchor" href="#_git"></a>GIT</h2> <div class="sectionbody"> <div class="paragraph"> <p>Fait partie de la suite <a href='/docs/git/fr'>git[1]</a></p> </div> </div> </div> <div class="sect1"> <h2 id="_traduction"><a class="anchor" href="#_traduction"></a>TRADUCTION</h2> <div class="sectionbody"> <div class="paragraph"> <p>Cette page de manuel a été traduite par Jean-Noël Avila <jn.avila AT free DOT fr> et les membres du projet git-manpages-l10n. Veuillez signaler toute erreur de traduction par un rapport de bogue sur le site <a href="https://github.com/jnavila/git-manpages-l10n" class="bare">https://github.com/jnavila/git-manpages-l10n</a> .</p> </div> </div> </div> </div> </div> </div> <footer> <div class="site-source"> <a href="/site">About this site</a><br> Patches, suggestions, and comments are welcome. </div> <div class="sfc-member"> Git is a member of <a href="/sfc">Software Freedom Conservancy</a> </div> </footer> <a href="#top" class="no-js scrollToTop" id="scrollToTop" data-label="Scroll to top"> <img src="/images/icons/chevron-up@2x.png" width="20" height="20" alt="scroll-to-top"/> </a> <script src="/js/jquery-1.7.1.min.js"></script> <script src="/js/jquery-ui-1.8.18.custom.min.js"></script> <script src="/js/jquery.defaultvalue.js"></script> <script src="/js/session.min.js"></script> <script src="/js/modernizr.js"></script> <script src="/js/modernize.js"></script> <script src="/js/application.min.js"></script> </div> </body> </html>