Plugin Espaço de trabalho

Abra uma pasta como espaço de trabalho e navegue, crie, renomeie e apague os arquivos dela a partir de um painel lateral — para que você trabalhe com um projeto inteiro, não apenas com arquivos avulsos.

Onde encontrá-lo

O menu Arquivo:

Comando	O que faz
Abrir pasta…	Escolha um diretório; ele vira a raiz do espaço de trabalho e o painel aparece.
Fechar a pasta	Fecha a pasta e os documentos que vivem nela — veja abaixo.
Atualizar o índice do espaço de trabalho	Relê a pasta para o Ir para arquivo agora, em vez de esperar a atualização automática.

A última pasta aberta é lembrada e restaurada na próxima inicialização. O painel não é aberto à força nessa restauração: se você ocultou o painel acoplável, ele continua oculto. Apenas um Abrir pasta… explícito o traz de volta.

Fechar uma pasta fecha os arquivos dela

Fechar a pasta fecha primeiro todas as abas abertas cujo arquivo está dentro do espaço de trabalho e depois limpa o espaço de trabalho. Arquivos de fora da pasta e buffers sem título são deixados em paz.

Um documento modificado levanta o aviso habitual de Salvar / Descartar / Cancelar — nada é fechado pelas suas costas. Pressionar Cancelar em qualquer um deles interrompe a operação inteira: a pasta continua aberta, e as abas já fechadas antes do cancelamento continuam fechadas. Pressione Fechar pasta de novo quando tiver decidido.

Ir para arquivo e o índice

O plugin mantém a lista de arquivos por trás do Ir para o arquivo (Ctrl+P) da paleta de comandos. Ela é construída em segundo plano: abrir uma pasta grande — ou uma em um compartilhamento de rede — não bloqueia mais o editor, e a paleta continua mostrando os arquivos da pasta anterior até a nova lista ficar pronta. A barra de status diz Indexando… enquanto ele trabalha e N arquivos indexados quando termina.

O índice é atualizado:

• automaticamente, cerca de dois segundos depois de algo mudar na raiz do espaço de trabalho ou em uma das subpastas imediatas dela. Apenas esse primeiro nível é monitorado — um monitor sobre uma árvore de fontes inteira custaria um descritor do sistema operacional por diretório — então uma alteração enterrada mais fundo aguarda um dos outros dois gatilhos;
• quando você salva um arquivo dentro da pasta: um arquivo recém-criado entra no índice na hora, sem nenhum novo percurso;
• sob demanda, por Arquivo ▸ Atualizar o índice do espaço de trabalho (também na paleta de comandos). Use-o depois de um git checkout, de um build, ou de qualquer outra coisa que rearranje a árvore de um jeito que o monitoramento raso não enxerga.

O índice suporta até o limite definido em Preferências ▸ Espaço de trabalho — 50 000 arquivos por padrão — para que uma árvore enorme nunca trave a paleta. Quando o percurso para nesse teto, a barra de status diz isso, em vez de deixar arquivos posteriores silenciosamente de fora do Ir para arquivo. Aumente-o (até 500 000) para uma cópia de trabalho muito grande, ou reduza-o se indexar uma pasta em um compartilhamento lento demorar demais.

Quais pastas são puladas

Alguns diretórios nunca valem a pena indexar: metadados do controle de versão, estado do ambiente de desenvolvimento, saída de build, árvores de dependências. Preferências ▸ Espaço de trabalho guarda a lista de nomes de diretório dentro dos quais o índice nunca olha — um por linha, comparados inteiros e com diferenciação de maiúsculas, em qualquer profundidade.

Os padrões são .git, .svn, .hg, .vs, .vscode, .idea, .cache, node_modules, build, Build, out, dist, bin, obj, target, __pycache__ e .mte-compile-commands. Edite a lista quando um projeto seu guardar fontes de verdade em algum lugar que aquele nome ocultaria — Restaurar os padrões devolve a lista ao estado original. Uma lista alterada reindexa a pasta aberta imediatamente.

Uma lista vazia significa "indexar tudo"; ela não é lida como "use os padrões".

O painel do espaço de trabalho

Uma árvore acoplável da pasta escolhida. Dê um duplo clique em um arquivo para abri-lo. A árvore se atualiza automaticamente quando os arquivos mudam no disco.

Dentro de cada pasta vêm primeiro as subpastas, depois os arquivos, cada grupo em ordem alfabética. Maiúsculas e minúsculas não são diferenciadas, e os números dentro de um nome são comparados pelo valor, então file2.txt vem antes de file10.txt. A ordem é a mesma no Windows e no macOS.

Clique com o botão direito em um item para ver o menu de contexto:

Ação	O que faz
Novo arquivo…	Cria um arquivo na pasta selecionada.
Nova pasta…	Cria uma subpasta.
Renomear…	Renomeia o arquivo ou a pasta selecionados.
Excluir…	Exclui o arquivo ou a pasta selecionados (com confirmação).
Mostrar no explorador	Mostra o item no gerenciador de arquivos do sistema.

Outros recursos acompanham o espaço de trabalho

Abrir uma pasta transmite a nova raiz para o resto do editor, de modo que recursos como Localizar em arquivos possam usar o espaço de trabalho atual como escopo padrão de busca.