Detectar o sistema operacional a partir de um script: uname, os-release, sw_vers, oslevel e uma ordem de fallback

Objetivo

Determinar, de dentro de um script, em que sistema operacional (e, quando for relevante, em que distribuição e versão) ele está sendo executado, com confiabilidade suficiente para escolher o comando correto entre as comparações desta série.

Pré-requisitos

Um shell POSIX (sh/bash) para alvos do tipo Unix, ou PowerShell para Windows; não se presume que haja outros utilitários pré-instalados além do próprio shell.

Passos

1. Comece com uname -s em qualquer shell POSIX. O comando distingue a família do kernel a baixo custo e existe em todo sistema do tipo Unix: Linux, Darwin (macOS), FreeBSD, AIX e assim por diante. Um shell POSIX no Windows informa, por exemplo, MINGW64_NT-... (Git Bash) ou CYGWIN_NT-..., enquanto o WSL informa Linux.
2. Se uname -s informar Linux, leia /etc/os-release (ou /usr/lib/os-release como alternativa, caso o primeiro não exista) e use os campos ID= e VERSION_ID= para obter a distribuição e a versão sem precisar interpretar banners em texto livre. Esse arquivo é a fonte padrão de identificação, legível por máquina, nas distribuições Linux modernas.
3. Se uname -s informar Darwin, execute sw_vers -productVersion para obter o número da versão do macOS; sw_vers -productName confirma que se trata do macOS e não de outro sistema baseado em Darwin.
4. Se uname -s informar FreeBSD, execute freebsd-version para a versão do userland e, separadamente, uname -r para a versão do kernel em execução: as duas podem diferir logo após uma atualização, até que o sistema seja reiniciado.
5. Se uname -s informar AIX, execute oslevel -s para obter a string do nível atual de manutenção/tecnologia.
6. Em um contexto em que o shell possa ser PowerShell em vez de POSIX (uma ferramenta de automação multiplataforma, PowerShell 7+ em Linux/macOS), verifique primeiro $IsWindows, $IsLinux e $IsMacOS — essas variáveis automáticas existem a partir do PowerShell 6 — e use $PSVersionTable.OS para mais detalhes. O Windows PowerShell 5.1 não tem nenhuma delas: lá, uma variável indefinida é avaliada como $null (ou gera erro sob Set-StrictMode). Por isso, teste $PSVersionTable.PSEdition -eq 'Desktop', que identifica o Windows PowerShell 5.1, um host exclusivo do Windows.
7. Se todas as fontes estruturadas acima estiverem indisponíveis (um ambiente mínimo ou incomum), recorra, como último recurso, à análise da saída em texto livre de uname -a e trate o resultado como de baixa confiança.

Resultado esperado

Um script obtém a família do SO e, quando aplicável, uma string de distribuição/versão usando a fonte estruturada mais específica disponível para essa família, com um caminho de fallback documentado em vez de uma única verificação frágil.

Limites e base de verificação

/etc/os-release é uma convenção documentada e amplamente adotada entre as distribuições Linux, não uma garantia imposta pelo kernel; uma imagem fora do padrão ou mínima ainda pode não tê-lo, e é por isso que o passo 7 existe. A detecção informa o que o SO é, não se ele ainda tem suporte; combine-a com a verificação de ciclo de vida desta série antes de automatizar uma ação em toda a frota de máquinas. Não se faz nenhuma afirmação de desempenho ou de tempo sobre esses comandos; eles são tratados apenas como verificações de correção.