Um atalho dentro do editor
A referência oficial de atalhos identifica Ctrl + Shift + H como Replace in Files no Windows. O comando pertence ao Visual Studio Code, não ao sistema operacional inteiro. Seu uso faz sentido quando um mesmo texto aparece em diferentes arquivos de um projeto: uma descrição repetida, um endereço ou um trecho de marcação. O ponto de partida é saber qual mudança se pretende realizar e em quais arquivos ela é necessária. Abrir o painel apenas prepara esse trabalho.
- Substituição de texto: Troca de uma sequência de caracteres por outra, nos arquivos escolhidos para a pesquisa.
Na documentação de edição básica, a busca entre arquivos opera na pasta aberta; sem uma pasta, fica restrita aos arquivos abertos. O painel oferece campos de inclusão e exclusão e uma prévia das diferenças. Ao preencher a substituição, é possível avaliar o resultado antes de aplicá-lo por ocorrência, por arquivo ou no conjunto. Isso permite começar pequeno e ampliar a operação somente quando os resultados correspondem à intenção.
Encontrar duas ocorrências iguais não significa que ambas cumpram a mesma função. Um nome pode aparecer em código, exemplos, documentação e arquivos de teste. A recomendação prática é definir o que deve mudar antes de aceitar uma substituição ampla. Em trabalho compartilhado, combine o alcance com quem mantém o projeto e preserve alterações já existentes. Assim, a revisão consegue distinguir a troca planejada de mudanças que estavam em andamento.
Como fazer uma troca controlada
Comece com uma cópia de trabalho que possa ser recuperada. Abra a pasta do projeto e pressione Ctrl + Shift + H. Para um exercício simples, imagine trocar a expressão literal class="menu-antigo" por class="menu-principal" em páginas HTML. Digite a primeira no campo de pesquisa e a segunda no campo de substituição. Confira os nomes dos arquivos e abra as ocorrências para ler o entorno. Este exemplo serve para entender a operação, não para recomendar a troca em qualquer site: se o CSS ainda depender de menu-antigo, mudar apenas o HTML poderá romper o estilo. Liste primeiro os trechos que precisam continuar coerentes e escolha uma ocorrência representativa para revisar.
Nos detalhes da busca, use o campo de inclusão para restringir os arquivos; **/*.html é um exemplo de padrão para páginas HTML. Confira também as exclusões antes de concluir que uma referência não existe. Faça a primeira alteração em um trecho cujo papel você compreenda. No exemplo do menu, compare a marcação com a regra de estilo correspondente. Uma pasta antiga de referência pode precisar permanecer intacta: a quantidade de resultados não decide o escopo por você.
- Pasta e objetivo definidos: Confira o projeto aberto e escreva qual resultado a troca precisa produzir nos arquivos.
- Ocorrências sob revisão: Leia o trecho ao redor de cada resultado e descarte usos que não pertencem à mudança.
- Resultado final conferido: Compare o antes e o depois e teste a parte do projeto atingida pela substituição.
Quando o objetivo é renomear uma variável ou função, avalie Rename Symbol e as refatorações do VS Code. O comando F2 pode renomear símbolos com apoio do serviço de linguagem, inclusive entre arquivos nas linguagens compatíveis. A substituição textual atende outra necessidade: troca caracteres correspondentes, sem garantir entendimento das relações do código. Escolha a operação pela mudança desejada e pelo suporte disponível no projeto.
Se o atalho não funcionar, abra o editor de atalhos de teclado e procure Replace in Files ou workbench.action.replaceInFiles. Personalizações e extensões de mapeamento podem mudar a combinação. Não altere atalhos ao acaso: confira qual comando está vinculado e se há conflito. Para pedir ajuda, anote o sistema, a combinação usada e o resultado observado, sem expor chaves, senhas ou conteúdo privado que possa aparecer nos arquivos.
Ao terminar, revise o conjunto das diferenças e confirme que a mudança resolveu o problema original. No exemplo, o menu deve continuar com o estilo e o comportamento pretendidos, e referências que deveriam permanecer iguais não podem ter sido alteradas. Verifique também o salvamento antes de fechar o trabalho. Uma cópia anterior ou o histórico do projeto ajuda a comparar o que mudou, mas não substitui a leitura. O procedimento útil é repetível: definir a intenção, delimitar o alcance, examinar ocorrências, aplicar a troca adequada e conferir o efeito. A velocidade do atalho só traz vantagem quando a edição continua compreensível para quem vai manter os arquivos depois.
Veja Mais
- Legendas revisadas tornam vídeos mais acessíveis e confiáveis
- Windows 11: entenda o que seu backup realmente salva
- YouTube amplia ferramentas e oportunidades para criadores em 2026
