A regra: reproduzir antes de alterar

Um relato útil descreve o comportamento esperado, o resultado real e as condições do teste. “Não inicia” é pouco. “Após selecionar UEFI no QEMU, aparece uma tela preta antes do terminal” já ajuda a isolar a etapa.

Ferramentas de inspeção

Dentro de um sistema Linux em execução, estes comandos podem ajudar:

CÓDIGO / COMANDO
uname -a
journalctl -b -p warning --no-pager
systemctl --failed
lsblk -o NAME,SIZE,TYPE,MOUNTPOINTS

lsblk aqui é apenas leitura. Não use comandos de formatação como método de depuração.

Diagnóstico por sintomas

Sintoma Primeiro ponto de verificação
mkarchiso falhou Mensagem final, pacotes e espaço livre
ISO não inicia Arquivos de boot, firmware da VM e perfil
Entra no terminal Sessão gráfica e gerenciador de login não configurados
Sem rede Adaptador da VM, serviço e logs
Tela preta Configuração de vídeo, display manager e logs
Instalou, não reinicia Bootloader e sistema realmente instalado

Registre o bug

Modelo:

CÓDIGO / COMANDO
Título: sessão gráfica não aparece no modo UEFI
Versão: 0.2-alpha
Ambiente: QEMU + UEFI
Esperado: abrir a tela de login
Obtido: termina no terminal
Como reproduzir: iniciar a ISO com run_archiso -i
Log relevante: [colar somente as linhas necessárias]
Status: aberto

Antes de divulgar logs, remova tokens, senhas, dados pessoais e endereços que não sejam necessários ao diagnóstico.