Skip to main content

Ajout d’un fichier à un référentiel

Vous pouvez charger et commiter un fichier existant dans un dépôt sur GitHub ou en utilisant la ligne de commande.

Platform navigation

Ajout d’un fichier à un référentiel sur GitHub

Les fichiers que vous ajoutez à un référentiel via un navigateur sont limités à 25 Mio par fichier. Vous pouvez ajouter des fichiers plus volumineux, jusqu’à 100 Mio chacun, via la ligne de commande. Pour plus d’informations, consultez « Ajout d’un fichier à un référentiel ». Pour ajouter des fichiers supérieurs à 100 Mio, vous devez utiliser Stockage Fichiers volumineux Git. Pour plus d’informations, consultez « À propos des fichiers volumineux sur GitHub ».

Conseils :

  • Vous pouvez charger simultanément plusieurs fichiers dans GitHub.
  • Si un référentiel possède des branches protégées, vous ne pouvez pas modifier ou charger des fichiers dans la branche protégée à l’aide de GitHub. Pour plus d’informations, consultez « À propos des branches protégées ».

Vous pouvez utiliser GitHub Desktop pour déplacer vos modifications vers une nouvelle branche et les valider. Pour plus d’informations, consultez « Commit et revue des changements apportés à votre projet dans GitHub Desktop ».

  1. Dans GitHub.com, accédez à la page principale du dépôt.

  2. Au-dessus de la liste des fichiers, sélectionnez le menu déroulant Ajouter un fichier, puis cliquez sur Charger des fichiers. Vous pouvez également glisser-déposer des fichiers dans votre navigateur.

    Capture d’écran de la page principale du référentiel. Au-dessus de la liste des fichiers, un bouton, intitulé « Ajouter un fichier », est indiqué en orange foncé.

  3. Pour sélectionner les fichiers que vous souhaitez charger, faites glisser et déposez le fichier ou le dossier, ou cliquez sur choisissez vos fichiers.

  4. Dans le champ de message de validation, tapez un message de validation court et descriptif qui indique la modification que vous avez apportée au fichier. Vous pouvez attribuer la validation à plusieurs auteurs dans le message de validation. Pour plus d’informations, consultez « Création d’une validation avec plusieurs auteurs ».

  5. Sous les champs de message de commit, choisissez si vous souhaitez ajouter votre commit à la branche actuelle ou à une nouvelle branche. Si votre branche actuelle est la branche par défaut, vous devez choisir de créer une branche pour votre validation, puis de créer une demande de tirage (pull request). Pour plus d’informations, consultez « Création d’une demande de tirage ».

    Capture d’écran d’une demande de tirage GitHub montrant une case d’option permettant de commiter directement dans la branche main ou de créer une branche. Une nouvelle branche est sélectionnée.

  6. Cliquez sur Proposer des modifications.

Ajout d’un fichier à un référentiel à l’aide de la ligne de commande

Vous pouvez charger un fichier existant dans un dépôt sur GitHub.com en utilisant la ligne de commande.

Cette procédure suppose que vous avez déjà :

Avertissement : N’appliquez jamais git add, commit ni push sur des informations sensibles pour un dépôt distant. Les informations sensibles peuvent être, sans s’y limiter :

Pour plus d’informations, consultez « Suppression de données sensibles dans un dépôt ».

  1. Sur votre ordinateur, déplacez le fichier que vous souhaitez charger vers GitHub dans le répertoire local créé lorsque vous avez cloné le référentiel.

  2. Ouvrez TerminalTerminalGit Bash.

  3. Remplacez le répertoire de travail actuel par votre dépôt local.

  4. Indexez le fichier pour commit dans votre dépôt local.

    $ git add .
    # Adds the file to your local repository and stages it for commit. Pour désindexer un fichier, utilisez « git reset HEAD VOTRE-FICHIER ».
    
  5. Validez le fichier dont vous avez placé une copie intermédiaire dans votre dépôt local.

    $ git commit -m "Add existing file"
    # Commits the tracked changes and prepares them to be pushed to a remote repository. Pour supprimer ce commit et modifier le fichier, utilisez « git reset --soft HEAD~1 », puis commitez et rajoutez le fichier.
    
  6. Poussez les modifications de votre référentiel local vers GitHub.com.

    $ git push origin YOUR_BRANCH
    # Pushes the changes in your local repository up to the remote repository you specified as the origin
    

Pour aller plus loin