Commandothèque

Édition française · relevé du 16 novembre 2026

Accueil

Fiche

sed -i : pourquoi la même ligne casse sur macOS et sous GNU

Sur macOS, sed -i exige une extension de sauvegarde ; sous GNU, elle est facultative et collée à l’option. La même ligne ne fait donc pas la même chose, et le message d’erreur ne nomme jamais l’option.

Rédaction Commandothèque

Sur macOS, sed -i exige une extension de sauvegarde : l’option consomme l’argument suivant. Sous GNU sed, cette extension est facultative et doit être collée à l’option. La ligne sed -i 's/a/b/' f est donc correcte sur Linux et fausse sur un Mac, où le script devient l’extension et le nom du fichier devient le script. Ce n’est pas un défaut récent : -i n’est pas spécifié par POSIX, et GNU comme BSD ont rempli le vide avec deux grammaires incompatibles.

Deux grammaires pour une seule option

GNU sed documente -i[SUFFIX], crochets compris : l’argument est optionnel et, lorsqu’il est présent, il doit toucher le tiret. BSD sed, celui que macOS livre, documente -i extension, sans crochets : l’argument est obligatoire, séparé ou collé. Les deux programmes lisent la même chaîne de caractères avec deux règles de découpage opposées, et c’est tout le problème.

La conséquence pratique tient en deux lignes. Sur macOS, sed -i '' 's/a/b/' f fonctionne : l’extension vide vaut « pas de sauvegarde ». Sur une machine GNU, la même ligne prend la chaîne vide comme script et le script comme nom de fichier, ce qui déplace l’erreur au lieu de la supprimer.

ImplémentationCommandeEffet observé
GNU sedsed -i 's/a/b/' fédite le fichier, aucune sauvegarde
GNU sedsed -i.bak 's/a/b/' fédite, écrit f.bak
BSD sedsed -i '' 's/a/b/' fédite, aucune sauvegarde
BSD sedsed -i 's/a/b/' féchec : script décalé d’un cran
BSD sedsed -i.bak 's/a/b/' fédite, écrit f.bak

Le message d’erreur qui ne parle pas de l’option

Sur un macOS récent, avec un fichier nommé note.txt, la commande sed -i 's/a/x/' note.txt renvoie sed: 1: "note.txt": extra characters at the end of n command et le code de sortie 1. Le message ne mentionne ni l’option ni l’extension : il cite le nom du fichier, devenu script par accident. Le fichier reste intact, ce qui rassure à tort.

Avec un nom d’une seule lettre, l’erreur change de forme. sed -i 's/a/x/' g affiche sed: -I or -i may not be used with stdin. Le script « g » est une commande sed valide, sed l’exécute, ne trouve plus de fichier et lit l’entrée standard. Le diagnostic dépend donc du nom du fichier, ce qui rend l’incident difficile à reconnaître d’un poste à l’autre.

Le cas -e, qui ne signale rien

La forme sed -i -e 's/a/y/' k est la plus coûteuse. BSD sed prend -e pour l’extension, édite le fichier et laisse une sauvegarde nommée k-e. Le code de sortie est 0, le fichier est bien modifié, et seul un ls attentif révèle la sauvegarde parasite. La boucle suivante, qui traite *, lira cette sauvegarde comme une donnée.

La forme qui passe partout

La seule écriture acceptée par les deux est l’extension collée : sed -i.bak 's/a/b/' f, suivie d’un rm -f f.bak. Elle crée une sauvegarde sur les deux systèmes, ce qui est un défaut dans un répertoire de données et un atout quand la modification est fausse.

  • Sans fichier temporaire : sed 's/a/b/' f > f.tmp && mv f.tmp f. Le remplacement reste sur le même système de fichiers, et le && empêche de déplacer un fichier vide quand sed échoue.
  • Détection de l’implémentation : sed --version >/dev/null 2>&1 réussit sous GNU et échoue sous BSD, qui répond illegal option -- -.
  • Sous GNU, --follow-symlinks évite de remplacer un lien symbolique par un fichier ordinaire ; sans cette option, le lien est rompu et la cible reste inchangée.

Ce que l’édition en place fait au fichier

GNU sed écrit un nouveau fichier puis le renomme sur l’ancien. Le numéro d’inode change, les liens durs se séparent, et les attributs étendus ou les ACL ne suivent pas toujours. Sur un fichier de configuration géré par un paquet, la modification peut être écrasée à la prochaine mise à jour, ou signalée comme une altération locale.

Ce détail explique la moitié des cas « la ligne est bonne mais l’effet a disparu » : une tâche plus tardive réécrit le fichier, ou un lien symbolique a été remplacé. Pour un fichier de configuration système, la bonne pratique reste un fichier de dépôt séparé ou un répertoire .d, pas une réécriture sur place.

Ce qu’il faut retenir dans un script

Dans un script destiné à plusieurs systèmes, sed -i ne doit apparaître qu’avec une extension explicite, testée sur les deux. Partout ailleurs, un fichier temporaire et un mv coûtent une ligne et rendent le contrôle d’erreur immédiat. Pour un remplacement de motif qui doit survivre aux deux mondes, perl -pi -e est souvent plus régulier, à condition d’accepter une dépendance de plus.

Enfin, un test vaut mieux qu’une conviction : sur la machine cible, lancer la commande exacte sur une copie, vérifier le code de sortie, puis comparer les deux fichiers avec diff. Un script qui modifie un fichier sans afficher de diff ne prouve rien.

Sources