Ditado por voz para programadores: fale a prosa, digite o código
Ninguém em sã consciência dita um for. Mas quem programa escreve muito texto comum todo dia: corpo de commit, descrição de pull request, comentário de code review, nota de arquitetura, card no Jira e prompt comprido para o assistente de código. É nessa prosa que o ditado por voz compensa. Este guia separa o que vale falar do que vale continuar digitando, traz frases prontas para cada caso e é direto sobre onde o reconhecimento de fala quebra em texto técnico, inclusive naquele português cheio de “deploy”, “merge” e “rollback” que todo time brasileiro fala.
Falar ou digitar: a regra de bolso
Se um colega conseguiria ler o trecho em voz alta sem soletrar nada, dite. Se tem identificador, sintaxe cheia de símbolos ou string exata, digite. Quase toda tarefa real é uma mistura: você fala as frases e digita os poucos tokens que ficam dentro delas.
| Tarefa | Ditar? | Por quê |
|---|---|---|
| Corpo da mensagem de commit | Sim | Duas ou três frases de raciocínio, quase só palavras comuns |
| Linha de assunto do commit | Quase sempre | É curta; o nome do arquivo ou da função você digita depois |
| Comentário de code review | Sim | Explicar uma preocupação falando sai mais rápido e mais educado |
| README e documentação | Sim, a parte em prosa | Blocos de código, comandos e caminhos vão no teclado |
| Prompt para assistente de código | Sim | Contexto longo é onde falar ganha mais de digitar |
| Nomes de variáveis e chamadas de função | Não | camelCase, underline e parênteses saem errados |
| Comandos de terminal, flags, regex | Não | Um caractere errado muda o significado |
| Caminhos de arquivo e URLs | Não | Barras e pontos são chatos de falar e fáceis de trocar |
Mensagem de commit ditada
Rode git commit sem o -m para o editor abrir. Escreva o assunto, ou dite e corrija os nomes, pule uma linha e dite o corpo. O corpo é justamente o que todo mundo pula quando digita, porque parece burocracia, e é o que explica a mudança para quem rodar git blame daqui a um ano.
Um corpo que cabe em uns quinze segundos de fala, com a pontuação dita: “O retry desistia depois do primeiro timeout porque o contador era zerado dentro do catch ponto final Movi o reset para antes do loop e adicionei um teste que simula dois timeouts seguidos ponto final”. Depois, se quiser, digite o nome do arquivo de teste.
Muitos times brasileiros escrevem commits em inglês. Nesse caso, dite em inglês: a ferramenta precisa estar com o idioma certo ativo, ou reconhecer os dois. Convenções de commit variam (assunto curto no imperativo, corpo quebrado em 72 colunas); o ditado não liga para quebra de linha, então ajuste no editor antes de salvar.
Comentários de code review que não soam grosseiros
Comentário de review digitado tende a sair seco, e seco parece rude. Falado, ele sai mais perto do que você diria na mesa ao lado. Um formato que funciona: o que você notou, por que importa, o que sugere.
Exemplo para ditar: “Essa query roda uma vez para cada item da lista vírgula então uma página com duzentos pedidos faz duzentas idas ao banco ponto final Dá para carregar tudo numa chamada só e agrupar em memória ponto de interrogação Se quiser a gente pareia nisso ponto final”. Depois clique de volta no comentário e coloque o nome da função entre crases à mão.
Releia cada comentário antes de publicar. Erro de reconhecimento numa nota pessoal é só um erro de digitação; num review, o autor do PR precisa adivinhar o que você quis dizer.
Documentação, notas de arquitetura e cards
Documentação é onde o desenvolvedor mais tem a dizer e menos paciência para digitar. Experimente dividir: dite a explicação seção por seção (“o que este serviço faz”, “como rodar localmente”, “o que quebra com mais frequência”) e digite depois cada comando, variável de ambiente e bloco de código. Um rascunho falado em dez minutos e editado em seguida costuma vencer o README vazio que espera uma tarde livre.
Em card de bug, fale os passos de reprodução como frases numeradas: “Passo um vírgula abrir a tela de configurações ponto final Passo dois vírgula mudar o fuso horário para Brasília e salvar ponto final Esperado que o painel atualize vírgula mas continua mostrando o fuso antigo ponto final”. Arrumar a numeração leva segundos, e os detalhes que você pularia digitando ficam registrados.
Prompts para assistentes de código
Assistentes de código respondem melhor com contexto: o que você está tentando fazer, o que já tentou, o que não pode mudar. Digitar tudo isso é lento, então a pessoa escreve uma linha e recebe uma resposta genérica. Falando, leva menos de um minuto.
Dite o contexto com palavras normais e cole o código ou a mensagem de erro à mão, porque stack trace e código têm de entrar exatos, nunca falados. O passo a passo de como estruturar prompts falados, incluindo a armadilha do “nova linha” que envia a mensagem no meio, está no guia de ditar prompts para o ChatGPT e o Claude.
Onde o ditado tropeça (e os poucos contornos)
- Identificadores. “get user by id” chega como quatro palavras. No Mac, a lista da Apple em português tem “ligar sem espaçamento” e “desligar sem espaçamento” para juntar a próxima frase, e “maiúsculas ligadas” para iniciais maiúsculas, mas montar um camelCase assim é mais lento do que digitar.
- Símbolos em série. O Ditado do Mac aceita “abrir parêntese”, “sublinhar” e “barra invertida”; a digitação por voz do Windows 11 em Português (Brasil) aceita “sublinhado”, “abre colchete” e até “aspa invertida” para a crase de código. Serve para um símbolo, é sofrido para uma linha inteira.
- Estrangeirismo e nomes de produto. Com o idioma em português, termos como “deploy”, “hotfix” ou o nome de uma biblioteca podem sair aportuguesados ou trocados por palavras parecidas. Digite esses termos, ou dite em volta e preencha a lacuna.
- Exatidão. Palavra errada num comentário é erro de digitação. Caractere errado num valor de configuração é bug. Nunca dite nada que vai ser executado ou interpretado por máquina.
- Escritório aberto. Falar com o computador o dia inteiro ao lado de colegas em call incomoda todo mundo. Apertar para falar e um headset ajudam; uma sala de reunião vazia ajuda mais.
Os nomes exatos de cada comando de pontuação e formatação em português, no Mac e no Windows, estão em como ditar pontuação.
Configuração que não atrapalha o fluxo
Quem programa troca de janela o tempo todo: editor, terminal, navegador, Slack. A ferramenta de ditado precisa escrever onde estiver o cursor, em todos eles, com um gesto só. O Ditado do Mac e a digitação por voz do Windows escrevem no cursor, mas a do Windows exige internet o tempo todo e a do Mac desliga depois de 30 segundos sem fala.
O Voice Monkeys é uma opção dedicada pensada nesse gesto: segure a Option direita no Mac (Alt direita no Windows e no Linux), fale, solte, e o texto aparece no cursor, inclusive no terminal ou na IDE. Um toque rápido deixa ouvindo até o próximo toque, e Esc cancela. Ele reconhece português e inglês misturados na mesma frase, o que ajuda com o vocabulário de time de tecnologia. Num Mac com Apple Silicon o modelo de fala roda no próprio Mac e o áudio não sai da máquina; se a sua empresa tem regras sobre para onde pode ir áudio de trabalho, confira com elas, isso não substitui perguntar. No Linux ele precisa de sessão X11, não Wayland. Dá para baixar e testar por 7 dias. Se você escreve pouca prosa e quase não sai do editor, a ferramenta do sistema talvez baste; para comparar tudo, veja a lista de aplicativos de ditado.
Perguntas e respostas
Dá para programar usando ditado por voz?
Ferramentas de ditado comuns são ruins para código: identificadores, colchetes e sintaxe exata saem errados. Elas funcionam bem para a prosa em volta do código, como corpo de commit, comentários de review, documentação e prompts.
Como ditar uma mensagem de commit?
Rode git commit sem -m para abrir o editor, escreva ou dite um assunto curto, pule uma linha e dite o corpo. Corrija nomes de arquivos e funções no teclado antes de salvar.
O ditado funciona no terminal?
Ferramentas que escrevem no cursor, como o Ditado do Mac, a digitação por voz do Windows e apps dedicados como o Voice Monkeys, escrevem no terminal como um teclado. Mas não dite comandos que você vai executar; esses, digite.
Como ditar underline, colchete e outros símbolos em português?
Diga o nome do símbolo. No Mac, a Apple lista “sublinhar”, “abrir colchete” e “barra invertida”; no Windows 11 em Português (Brasil), a Microsoft lista “sublinhado”, “abre colchete” e “aspa invertida”. As palavras mudam de sistema para sistema.
É seguro ditar descrições de código do trabalho?
Depende de onde a fala é processada e das regras da sua empresa. Verifique se a ferramenta processa o áudio no aparelho ou num servidor e compare com a política interna. O guia sobre privacidade no ditado por voz mostra o que conferir.
Fontes
- Apple: Comandos para ditar texto no Mac (verificado 6 de novembro de 2026)
- Apple: Dite mensagens e documentos no Mac (verificado 6 de novembro de 2026)
- Microsoft: Usar a digitação de voz para falar em vez de digitar no computador (verificado 6 de novembro de 2026)