Como Editar uma Macro no Editor VBA do Word

Você gravou uma macro no Word usando o gravador interno, mas as etapas gravadas não correspondem ao que você precisa. O Gravador de Macros cria código VBA baseado em seus cliques e teclas, e esse código geralmente inclui seleções desnecessárias ou valores fixos. Para alterar o comportamento da macro, você deve abrir o editor do Visual Basic for Applications e modificar o código diretamente. Este artigo explica as etapas exatas para localizar, abrir e editar uma macro no editor VBA, além de abordar alterações comuns de código que os usuários precisam fazer.

O que o Editor VBA Faz e o que Você Precisa Antes de Editar

O editor do Visual Basic for Applications é uma janela separada dentro do Word que permite ler, escrever e alterar código VBA. Cada macro que você grava ou escreve manualmente é armazenada em um módulo de código dentro de um documento ou modelo. Quando você grava uma macro, o Word escreve instruções VBA que espelham suas ações, mas o gravador adiciona linhas extras como Selection.GoTo ou Selection.TypeText que tornam a macro lenta e frágil. Editar a macro no editor VBA remove essas linhas redundantes e permite adicionar lógica, loops e condicionais.

Antes de editar uma macro, você precisa saber o nome da macro e onde ela está armazenada. As macros podem ser salvas no documento atual, no modelo Normal.dotm ou em outro modelo global. Você também precisa de familiaridade básica com a sintaxe VBA, como entender que linhas iniciadas com apóstrofo são comentários e que Sub marca o início de um procedimento. O Word não exige permissões especiais para abrir o editor VBA, mas se sua organização bloquear macros via Política de Grupo, você não poderá editá-las ou executá-las.

Etapas para Abrir e Editar uma Macro no Editor VBA

As etapas a seguir usam o atalho de teclado Alt + F11 para abrir o editor. Este método funciona no Word para Microsoft 365, Word 2021, Word 2019 e Word 2016 no Windows 10 e Windows 11. Se preferir o caminho da faixa de opções, use Exibir > Macros, selecione a macro e clique em Editar.

1. Abra o editor VBA
   Pressione Alt + F11 no teclado. A janela do editor VBA aparece. Se você já tiver uma macro gravada, o editor abre com uma árvore de projeto vazia. Não feche o Word.
2. Localize o módulo da macro no Project Explorer
   Observe o painel do Project Explorer no lado esquerdo do editor VBA. Se não o vir, pressione Ctrl + R para exibi-lo. Expanda o projeto que corresponde ao seu documento aberto. Por exemplo, se seu documento se chama Relatorio.docx, expanda Project (Relatorio.docx). Em seguida, expanda a pasta Modules. Você verá Module1 ou um módulo com o nome da sua macro.
3. Abra o módulo que contém sua macro
   Clique duas vezes no nome do módulo no Project Explorer. A janela de código à direita exibe o código VBA. Se você gravou uma macro chamada FormatText, verá um procedimento Sub que começa com Sub FormatText() e termina com End Sub.
4. Edite o código da macro
   Clique dentro da janela de código e faça suas alterações. Edições comuns incluem remover linhas Selection.GoTo, substituir tamanhos de fonte fixos por variáveis ou adicionar um loop para processar vários parágrafos. Após terminar a edição, pressione Ctrl + S para salvar o módulo. A macro agora está atualizada no documento.
5. Teste a macro no Word
   Volte ao Word pressionando Alt + F11 novamente ou clicando na janela do Word. Execute a macro usando Exibir > Macros, selecione o nome da macro e clique em Executar. Verifique se o resultado corresponde ao seu código editado. Se a macro falhar, retorne ao editor VBA e verifique a sintaxe.

Editando uma Macro Armazenada no Modelo Normal.dotm

Se você gravou a macro no modelo Normal.dotm para que esteja disponível em todos os documentos, o módulo aparece em Project (Normal). Expanda Project (Normal) > Modules e clique duas vezes no módulo. As alterações no Normal.dotm afetam todos os novos documentos que usam esse modelo. Tenha cuidado ao editar macros do Normal.dotm, pois um erro pode quebrar macros em todos os seus documentos.

Editando uma Macro Atribuída a um Botão ou Atalho de Teclado

Se você atribuiu a macro a um botão na Barra de Ferramentas de Acesso Rápido ou a um atalho de teclado, editar o código não altera a atribuição. Após editar o código, o botão ou atalho ainda chama o mesmo nome da macro. Você não precisa reatribuir a macro, a menos que mude seu nome.

Erros Comuns ao Editar Macros e Como Evitá-los

O Editor VBA Mostra um Erro de Compilação Quando Tento Executar a Macro

Um erro de compilação significa que o código VBA contém um erro de sintaxe. Causas comuns incluem um Next ausente para um loop For, um erro de digitação no nome de uma variável ou um End If ausente. O editor VBA destaca a linha com o erro. Verifique essa linha e as linhas imediatamente anteriores. Corrija o erro de digitação ou adicione a palavra-chave ausente, pressione Ctrl + S e tente novamente.

A Macro Para de Funcionar Após Editá-la, Mas Nenhum Erro Aparece

Se a macro for executada mas não fizer nada, o código provavelmente contém um erro de lógica. Por exemplo, você pode ter alterado um contador de loop para um valor que nunca corresponde, ou removeu uma linha que selecionava o intervalo correto. Para depurar, adicione um ponto de interrupção clicando na margem esquerda ao lado de uma linha. Execute a macro; ela pausa no ponto de interrupção. Pressione F8 para percorrer cada linha e observe os valores na janela Immediate (pressione Ctrl + G para abri-la).

Não Consigo Ver o Project Explorer ou a Janela de Código

Se o editor VBA abrir mas mostrar apenas uma área cinza, pressione Ctrl + R para exibir o Project Explorer. Se a janela de código estiver ausente, clique duas vezes em um módulo no Project Explorer. Se a lista de módulos estiver vazia, você ainda não gravou ou criou nenhuma macro. Feche o editor, grave uma macro no Word e reabra o editor.

Faixa de Opções do Editor VBA vs Atalhos de Teclado: Diferenças de Navegação

Item	Caminho da Faixa de Opções (Guia Exibir)	Atalho de Teclado
Abrir editor VBA	Exibir > Macros > Exibir Macros > Selecionar macro > Editar	Alt + F11
Mostrar Project Explorer	No editor VBA: Exibir > Project Explorer	Ctrl + R
Mostrar janela Immediate	No editor VBA: Exibir > Immediate Window	Ctrl + G
Percorrer o código linha a linha	No editor VBA: Depurar > Step Into	F8
Salvar alterações do módulo	No editor VBA: Arquivo > Salvar (nome do documento)	Ctrl + S

Agora você pode abrir o editor VBA, localizar qualquer módulo de macro e modificar o código VBA para remover linhas redundantes ou adicionar lógica. Pratique a edição de uma macro gravada simples, excluindo as linhas Selection.GoTo e substituindo-as por referências diretas a objetos. Use a janela Immediate com Ctrl + G para testar pequenos trechos de código antes de adicioná-los à sua macro.