Monitoramento de alterações em arquivos

O editor monitora todos os arquivos abertos e percebe quando eles mudam no disco — quando outro programa os reescreve, quando você traz novas alterações do controle de versão, ou quando um arquivo que você tem aberto é excluído. Isso mantém a visualização em sincronia com o estado real dos seus arquivos e ajuda a evitar sobrescrever trabalho feito em outro lugar.

O que acontece quando um arquivo muda

• Modificado externamente — você é avisado, para que a visualização nunca mostre conteúdo desatualizado em silêncio. Pela notificação você pode:
  • Recarregar o arquivo para incorporar as alterações externas, ou
  • Comparar a versão em disco com a que você tem aberta (veja Comparar / Diff).
• Excluído externamente — você é avisado de que o arquivo sumiu, para que possa salvá-lo de novo a partir do buffer que ainda tem aberto, se quiser preservá-lo.

Se um arquivo muda enquanto não é a aba que você está olhando, o editor não interrompe você — ele espera e pergunta na próxima vez que você mudar para aquela aba.

Silencioso por design

Salvar pelo editor não dispara um falso alerta de "alterado no disco" — o editor reconhece as próprias gravações. As notificações têm atraso, de modo que uma rajada de gravações externas (por exemplo, uma ferramenta de build reescrevendo um arquivo) resulta em um único aviso, não em uma enxurrada.

Um arquivo que continua mudando pergunta uma única vez — você não receberá um novo aviso a cada gravação enquanto mantiver sua versão. O editor pergunta de novo na próxima vez que você voltar àquela aba (caso então queira pegar o conteúdo mais novo). Se preferir acompanhar as alterações ao vivo em vez de ser perguntado, use o Monitoramento.

Configurações

Preferências ▸ Geral ▸ Monitoramento de arquivos contém duas opções. Ambas valem imediatamente — sem reiniciar.

Opção	Padrão	Efeito
Monitorar alterações externas nos arquivos abertos	ligado	O interruptor mestre. Com ele desligado, o editor deixa de perceber alterações externas por completo: sem recarregamentos, sem avisos, sem marcações de "excluído no disco" — e um arquivo que você colocou em Monitoramento para de acompanhar o final dele.
Recarregar os documentos não modificados sem avisar	ligado	Uma aba sem edições não salvas é atualizada a partir do disco sem perguntar, de modo que um pull do controle de versão ou uma recompilação simplesmente atualizam o que você vê. Desligue para ser perguntado todas as vezes.

Uma aba com edições não salvas sempre pergunta antes de qualquer recarga, como quer que essas opções estejam — suas edições nunca são descartadas em silêncio. A segunda opção só tem efeito enquanto a primeira está ligada, então ela fica esmaecida quando o monitoramento está desligado.

Voltar a ligar o monitoramento coloca tudo em dia: todos os arquivos abertos são reconferidos contra o estado em que se sabia que estavam pela última vez, e tudo o que mudou enquanto o monitoramento estava desligado é reportado de imediato — recarregado ou oferecido como aviso, exatamente como se tivesse acontecido com o monitoramento ligado.

Monitorando um arquivo (tail -f)

Quando outro programa está acrescentando continuamente ao final de um arquivo — um log, a saída de um build, um relatório sendo gerado — você normalmente quer acompanhá-lo em vez de ser perguntado sobre recarregar. Ligue Exibir ▸ Monitoramento (tail -f) para o arquivo ativo e o editor vai:

• Acompanhar o final — novas linhas acrescentadas no disco são adicionadas à visualização e o editor rola até o fim, para que o conteúdo mais recente continue visível.
• Manter o buffer somente leitura — durante o monitoramento, o arquivo espelha o que está no disco, então a edição fica desativada (os comandos que alteram o documento ficam esmaecidos) e o arquivo nunca é sobrescrito. Isso é deliberado: você está observando um arquivo que pertence a outro programa, e gravar sua cópia de volta destruiria o que ele está acrescentando.

Desligue o mesmo item de menu para parar de acompanhar; o buffer volta a ser editável, mantendo o que estava na tela.

Começar a monitorar um arquivo com edições não salvas pergunta primeiro — Descartar e monitorar joga fora suas edições e acompanha o arquivo no disco, ou Cancelar deixa o arquivo como está. Não há uma opção de "salvar primeiro", porque salvar sobrescreveria o arquivo que o outro programa está gravando.

O monitoramento é por arquivo e não é lembrado entre sessões — reabra um arquivo e ele começa como um documento normal e editável. Apenas arquivos salvos podem ser monitorados.

Tip

Para trabalho estruturado com logs — filtrar por nível, linhas do tempo, mesclar várias fontes, acompanhar a rotação de app.log → app.log.1 — abra o arquivo no Analisador de logs dedicado. O monitoramento daqui é a opção leve de "só quero ver este arquivo crescer", válida para qualquer arquivo.