Localizar e substituir em vários arquivos

Sobre substituir texto em vários arquivos

O Windows sabe procurar dentro de arquivos pela linha de comando. O findstr /s vai listar todos os arquivos que mencionam uma palavra.

Ele não sabe substituir. Para isso é preciso um laço do PowerShell — Get-Content, -replace, Set-Content — e esse laço tem o costume de destruir justamente os arquivos que deveria consertar.

Esta ferramenta faz o mesmo trabalho com o passo que falta nesse laço: ela mostra cada linha que mudaria, antes e depois, e não grava nada até você mandar.

Como usar

• Clique em Escolher uma pasta e selecione-a
• Digite o que procurar e o que colocar no lugar
• Preencha Somente estes tipos se quiser só os .html ou só os .csv
• Aperte Ver as alterações e leia a lista — cada linha como está e como ficaria
• Marque a caixa e aperte Alterar os arquivos agora — ou crie um ZIP só com os arquivos alterados

O que o laço do PowerShell erra

• A codificação. O Set-Content grava na página de código do console, então um arquivo UTF-8 volta com os acentos destruídos. Aqui cada arquivo é decodificado corretamente e regravado como UTF-8, e um arquivo que tinha marca de ordem de bytes a mantém
• As quebras de linha. O mesmo laço regrava CRLF como LF. Num repositório git isso aparece como *todas as linhas alteradas* no commit seguinte. Aqui as quebras ficam exatamente como estavam, linha a linha, mesmo num arquivo que mistura as duas
• Nenhuma prévia. O laço roda e você descobre depois. É toda a razão de existir desta ferramenta

Três formas de procurar

• Texto simples — o que você digita é o que se encontra. $1 continua $1
• Somente palavras inteiras — gato não vai casar dentro de gatinho
• Expressão regular — regex completo, e $1 na caixa de substituição vira um grupo capturado. Serve para coisas como transformar 2026-09-10 em 10/09/2026 de uma passada

Diferenciar maiúsculas e minúsculas vem desligado, então Cor e cor são ambos encontrados.

Arquivos que não são texto são pulados

Um byte NUL no primeiro bloco significa que o arquivo não é texto. Substituir dentro de um JPEG o corromperia enquanto cada passo da ferramenta anuncia sucesso, então esses arquivos são pulados — e contados, para você ver que aconteceu. Arquivos com mais de 8 MB e os que o sistema não abre são contados do mesmo jeito. Uma ferramenta que ignorasse em silêncio metade de uma pasta seria pior do que uma que recusa.

Gravar no lugar, ou um ZIP

Chrome, Edge e Opera podem receber permissão de escrita na pasta escolhida, e os arquivos são alterados ali. Guardar uma cópia .bak vem ligado: cada original é copiado ao lado de si mesmo como pagina.html.bak antes de ser regravado, e o backup é gravado primeiro, então uma falha deixa o original intacto.

Qualquer navegador pode, em vez disso, criar um ZIP só com os arquivos que mudam, com a estrutura de pastas intacta, pronto para descompactar sobre os originais. Também é a melhor escolha quando a pasta é uma cópia que você prefere conferir antes de sobrescrever qualquer coisa — e é um registro natural do que a ferramenta fez exatamente.

Para que as pessoas usam

• Trocar um domínio, URL ou nome de empresa na pasta inteira de um site
• Atualizar um ano, preço ou número de versão em todos os documentos de uma vez
• Corrigir um nome escrito errado num conjunto de registros exportados
• Trocar um marcador de posição por um valor real numa pasta de modelos
• Mudar um separador ou formato de data numa pasta de exportações CSV
• Remover um parâmetro de rastreamento ou trecho antigo de cada página

Bom saber

• Nada é gravado até você marcar a caixa e apertar o botão
• Mudar uma opção descarta a prévia em vez de deixar uma lista que já não corresponde ao que aconteceria
• Depois de gravar, o resultado é limpo — os arquivos já não contêm o texto antigo, então um segundo clique não pode aplicar a mesma alteração duas vezes
• Arquivos que não são texto, são grandes demais ou não abrem são pulados e contados
• As quebras de linha e a marca de ordem de bytes são preservadas arquivo por arquivo
• A prévia lista os primeiros 200 arquivos e as primeiras 50 linhas alteradas de cada um; ao aplicar, todos os arquivos são cobertos
• Funciona no Windows, macOS, Linux e ChromeOS. Navegadores de celular não conseguem entregar uma pasta a uma página web, então não vai funcionar em celular nem tablet

Ferramentas relacionadas

• Procurar texto em arquivos — pesquisar na mesma pasta sem alterar nada
• Localizar e substituir — a mesma ideia para um bloco de texto colado
• Renomear arquivos em lote — mudar os nomes em vez do conteúdo
• Conversor de codificação — corrigir acentos já quebrados
• Comparador de textos — comparar duas versões linha a linha