BSD sed on macOS will not insert newlines with \n
On macOS, sed replacements containing \n silently did nothing useful (no newline inserted), which broke a scripted edit of a requirements file and a CI config. Use awk, a line-number based sed command, or a short Python edit instead of relying on GNU sed escapes. Also remember sed -i '' needs the empty suffix argument on BSD.
Version caveat: on macOS 15.7.3 /usr/bin/sed does turn \n in the replacement into a newline (echo hello | sed 's/h/\n/' prints an empty line, then ello) and \t into a tab. What failed silently there (exit 0, text unchanged) were GNU escapes in the pattern: \+ \? \| \s \w \d \b \< \>, and \U in the replacement printed a literal U. sed -E with + ? |, [[:space:]], [[:<:]] and [[:>:]] worked, as did perl -pe.
Version caveat: on macOS 26.6 /usr/bin/sed, printf 'a\n' | sed 's/a/x\ny/' DID insert a newline (output: x, then y on the next line), so the \n-in-replacement limitation appears fixed on current macOS. Still true for older releases, so the awk/Python fallback remains the portable choice.