O que é um 'espaço de trabalho' no Código do Visual Studio?

Não acredito que estou fazendo essa pergunta, mas não consegui encontrar uma definição na documentação. Caso não seja dolorosamente óbvio, sou (muito) novo no Visual Studio Code.

Por exemplo, o Visual Studio Code fala sobre aplicação de configurações no nível do usuário versus no nível da área de trabalho .

Por um lado,

• (a) pode se referir a um diretório de projeto que você abriu; ou
• (b) pode se referir a tudo que você abriu em uma janela específica.

A página mencionada acima diz

"Workspace: These settings are stored inside your workspace
in a .vscode folder and only apply when the workspace is opened."

O que é um espaço de trabalho?

Um projeto que consiste em uma ou mais pastas raiz, juntamente com todas as configurações de código do Visual Studio que pertencem a esse projeto. Uma "pasta raiz" é o diretório de nível superior de um sistema de arquivos. Essas configurações incluem dados como:

• configurações que devem ser aplicadas quando esse projeto estiver aberto
• extensões recomendadas para o projeto (útil ao compartilhar os arquivos de configuração com os colegas)
• configurações de depuração específicas do projeto

Por que um espaço de trabalho é tão confuso?

O Código do Visual Studio não usa o termo de forma consistente na interface do usuário (eu abri um problema do GitHub para resolver isso). Às vezes, refere-se a uma área de trabalho, conforme descrito acima, e outras vezes, a uma área de trabalho como um projeto especificamente associado a um .code-workspacearquivo.

Um bom exemplo é o widget de arquivos recentes . Observe na captura de tela vinculada que todos os projetos estão agrupados no mesmo cabeçalho "áreas de trabalho", o que indicaria que tudo existe em uma área de trabalho. Mas então projeta com um.code-workspace arquivo recebem um sufixo "Área de trabalho", contradizendo o cabeçalho e indicando que somente esses arquivos são realmente áreas de trabalho.

O que é um .code-workspacearquivo?

Um arquivo JSON com comentários que armazena todos os dados de configuração mencionados acima, além de:

• o local de todas as pastas raiz pertencentes a um espaço de trabalho

Preciso de um .code-workspacearquivo?

Somente se você estiver criando um espaço de trabalho com várias raízes . Com um espaço de trabalho com várias raízes, você tem um único .code-workspacearquivo que abre todas as pastas raiz que deseja exibir no explorer (ou seja, não é necessário continuar abrindo várias pastas manualmente). E todas as configurações / configurações do Código do Visual Studio que você deseja aplicar a esse espaço de trabalho são restauradas toda vez que você abre esse arquivo do espaço de trabalho.

E os projetos de pasta única?

Tudo é automatizado. Quando você abre uma pasta no Visual Studio Code e começa a fazer modificações no editor especificamente relacionadas ao projeto em que está trabalhando, o Visual Studio Code cria automaticamente uma .vscodepasta e a armazena na raiz da pasta do projeto que você ' está trabalhando. Esta .vscodepasta possui arquivos que armazenam as alterações feitas. Por exemplo, se você alterar as configurações do Código do Visual Studio que deseja aplicar apenas ao seu projeto atual, o Código do Visual Studio criará um settings.jsonarquivo com essas atualizações e esse arquivo será armazenado na .vscodepasta.

Você pode criar um .code-workspacearquivo que inclua apenas uma única pasta raiz, se realmente desejar. Você poderá abrir a pasta do projeto diretamente ou abrir o arquivo da área de trabalho. Mas não consigo pensar em nenhuma razão para isso ser benéfico.

Como crio um .code-workspacearquivo?

Vá para o menu Arquivo → Salvar espaço de trabalho como ...

Como adiciono pastas raiz a um espaço de trabalho?

Ir para o menu Arquivo → Adicionar pasta à área de trabalho ... .

Como abro um espaço de trabalho definido por um .code-workspacearquivo?

Clique duas vezes no .code-workspacearquivo. O Código do Visual Studio não abrirá o arquivo real. Em vez disso, ele lerá esse arquivo e abrirá as pastas pertencentes a esse espaço de trabalho. Alternativamente, vá ao menu Arquivo → Abrir espaço de trabalho ... .

Como visualizo o .code-workspacearquivo real ?

Vá para o menu Arquivo → Abrir ... e selecione o .code-workspacearquivo de destino . Como alternativa, abra a área de trabalho associada a esse arquivo e abra a paleta de comandos , procure e selecione os espaços de trabalho: Abrir arquivo de configuração do espaço de trabalho .

Você pode salvar as configurações no nível da área de trabalho e abrir várias pastas em uma área de trabalho. Se você quiser fazer uma dessas coisas, use uma área de trabalho; caso contrário, basta abrir uma pasta.

Um espaço de trabalho Código do Visual Studio é uma lista de pastas e arquivos de um projeto. Um espaço de trabalho pode conter várias pastas. Você pode personalizar as configurações e preferências de um espaço de trabalho.

Um espaço de trabalho é apenas um arquivo de texto com uma extensão (.code-workspace). Você pode vê-lo abrindo-o com um editor de texto. Eu também fiquei frustrado com a idéia de um espaço de trabalho e como ele é implementado no Visual Studio Code. Eu encontrei um método que combina comigo.

Comece com uma única pasta "projeto".

Abra o Código do Visual Studio e feche todos os espaços de trabalho, arquivos ou pastas abertos. Você deve ver apenas "OPEN EDITORS" e "NO FOLDER OPENED" no EXPLORER.

Na barra de menu * → Arquivo → Abrir pasta ... . Navegue até onde deseja colocar sua pasta e clique com o botão direito do mouse para abrir uma nova pasta. Dê o nome que desejar e clique em "Selecionar pasta" . Ele aparecerá no * Visual Studio Code explorer.

Agora, a partir do menu Arquivo → Salvar espaço de trabalho como ... . Nomeie o espaço de trabalho e salve-o onde quiser manter todos os seus espaços de trabalho (não necessariamente onde estão as pastas do projeto). Coloquei todo o meu em uma pasta chamada "Área de trabalho do Visual Studio Code".

Ele será salvo como um .code-workspacearquivo ( ) e é apenas um índice para todos os arquivos e pastas que ele contém (ou aponta para) onde quer que estejam no disco rígido. Você pode vê-lo abrindo-o com um editor de texto. Feche a pasta que você criou e feche o Visual Studio Code.

Agora encontre o "arquivo" do seu espaço de trabalho e clique duas vezes nele. Isso abrirá o Visual Studio Code com a pasta que você criou no seu espaço de trabalho. Ou você pode abrir o Código do Visual Studio e usar "Abrir espaço de trabalho" .

Todas as pastas que você criar no espaço de trabalho Código do Visual Studio estarão dentro da sua primeira pasta. Se você deseja adicionar mais pastas de nível superior, crie-as primeiro onde quiser e, em seguida, use "Adicionar à área de trabalho .." no Código do Visual Studio.

O título e a pergunta subsequente no PO parecem resumir-se a:

1. O que é um espaço de trabalho no VS Code?
2. Como as configurações da área de trabalho funcionam?

Resposta curta:

Um espaço de trabalho é uma coleção virtual de pastas abertas simultaneamente no VSCode e definidas em um .code-workspacearquivo. Abrir este arquivo abrirá a coleção de pastas automaticamente. Isso é chamado de espaço de trabalho "multi-raiz".

O .code-workspacearquivo também define configurações da área de trabalho que são usadas pela instância do VSCode em que a área de trabalho é aberta.

Quando um espaço de trabalho não está definido, ou seja, você abre uma pasta por si só, é possível criar "configurações do espaço de trabalho" que são salvas em um .vscode\settings.jsonarquivo na raiz dessa estrutura de pastas.

Em mais detalhes:

O VSCode usa a palavra "espaço de trabalho" um pouco ambiguamente em alguns lugares. O primeiro uso a considerar é o que chamamos de espaço de trabalho com várias raízes .

Um espaço de trabalho com várias raízes é um conjunto de pastas (as "raízes") que são abertas coletivamente em uma instância do VSCode. Não há necessidade dessas pastas compartilharem pastas pai; de fato, esse é o ponto, pois o VSCode normalmente usa uma única pasta na barra lateral do Explorer.

Um espaço de trabalho com várias raízes é definido por um .code-workspacearquivo (JSON) que contém a lista de pastas a serem incluídas no espaço de trabalho e nas configurações do VSCode.

• https://code.visualstudio.com/docs/editor/multi-root-workspaces

Em relação às configurações da área de trabalho ...

Quando você abre Arquivo> Preferências> Configurações, o editor de configurações é mostrado. No mínimo, você deverá ver uma guia CONFIGURAÇÕES DO USUÁRIO . Essas são as configurações do VSCode que são universais para sua conta de usuário em sua máquina local. No Windows, eles são salvos em %APPDATA%\Code\User\settings.json.

• Locais dos arquivos de configurações de código do VS

Pastas individuais (geralmente cada uma das pastas "raiz" em um espaço de trabalho) podem ter uma .vscodepasta com seu próprio settings.jsonarquivo. Quando aberto individualmente, ou seja, não como parte de uma área de trabalho, o conteúdo desses settings.jsonarquivos é apresentado na guia CONFIGURAÇÕES DO ESPAÇO DE TRABALHO , e TODAS as configurações desse arquivo são usadas pela instância do VSCode em execução.

Ao abrir um espaço de trabalho com várias raízes, as coisas se comportam de maneira diferente. Primeiramente, a guia CONFIGURAÇÕES DO ESPAÇO DE TRABALHO mostra as opções definidas no .code-workspacearquivo. Em segundo lugar, qualquer pasta com um settings.jsonarquivo aparecerá em uma nova guia CONFIGURAÇÕES DE PASTA . Lembre-se de que, quando em um espaço de trabalho com várias raízes, apenas um número limitado de configurações de cada pasta é settings.jsonusado. Eu sugiro que você abra o link acima para ler mais.

O principal utilitário de um espaço de trabalho (e talvez o único) é permitir adicionar várias pastas independentes que compõem um projeto. Por exemplo:

- WorkspaceProjectX  
-- ApiFolder   (maybe /usr/share/www/api)  
-- DocsFolder  (maybe /home/user/projx/html/docs)  
-- WebFolder   (maybe /usr/share/www/web)

Assim, você pode agrupar aqueles em um espaço de trabalho para um projeto específico, em vez de precisar abrir várias janelas de pastas.

Você pode aprender mais aqui .

Em alguma investigação, a resposta parece ser (a).

Quando vou alterar as configurações, o arquivo de configurações entra em um diretório .vscode no diretório do meu projeto.

Acabei de instalar o Visual Studio Code v1.25.1. em uma máquina Windows 7 Professional SP1. Como eu queria entender os espaços de trabalho em detalhes, passei algumas horas descobrindo como eles funcionam nesta versão do Visual Studio Code. Eu pensei que os resultados da minha pesquisa poderiam ser do interesse da comunidade.

Primeiro, os espaços de trabalho são referidos pela Microsoft na documentação do Visual Studio Code como "espaços de trabalho com várias raízes". Em inglês simples, isso significa "um ambiente de trabalho com várias pastas (também conhecido como" raiz ")". Um espaço de trabalho Código do Visual Studio é simplesmente uma coleção de pastas - qualquer coleção que você desejar, na ordem que desejar. A coleção típica de pastas constitui um projeto de desenvolvimento de software. No entanto, uma coleção de pastas pode ser usada para qualquer outra coisa para a qual o código de software está sendo desenvolvido.

A mecânica por trás de como o Visual Studio Code lida com os espaços de trabalho é um pouco complicada. Acho que a maneira mais rápida de transmitir o que aprendi é fornecendo um conjunto de instruções que você pode usar para ver como os espaços de trabalho funcionam no seu computador. Suponho que você esteja começando com uma nova instalação do Visual Studio Code v1.25.1. Se você estiver usando uma versão de produção do Visual Studio Code , não recomendo que você siga minhas instruções, pois poderá perder parte ou toda a sua configuração existente do Visual Studio Code! Se você já possui uma versão de teste do Visual Studio Code v1.25.1 instalada **, e deseja perder qualquer configuração que já exista, é necessário fazer o seguinte para reverter o código do Visual Studio para um novo estado de instalação:

Exclua a seguinte pasta (se existir):

  C:\Users\%username%\AppData\Roaming\Code\Workspaces (where "%username%" is the name of the currently logged-on user)

Você adicionará pastas ao Visual Studio Code para criar um novo espaço de trabalho. Se alguma das pastas que você pretende usar para criar esse novo espaço de trabalho tiver sido usada anteriormente com o Visual Studio Code, exclua a subpasta ".vscode" (se existir) em cada uma das pastas que serão usadas para criar o novo espaço de trabalho .

Inicie o Visual Studio Code. Se a página de boas - vindas for exibida, feche-a. Faça o mesmo para o painel (um painel horizontal) se ele for exibido. Se você recebeu uma mensagem de que o Git não está instalado, clique em "Lembrar-me mais tarde". Se exibido, feche também a página de código "Sem título" que foi iniciada como a página de código padrão. Se o painel do Explorer não for exibido, clique em "Exibir" no menu principal e clique em "Explorer" para exibir o painel do Explorer. Dentro do painel do Explorer, você deverá ver três (3) cabeçalhos de exibição - editores abertos, nenhuma pasta aberta e estrutura de tópicos (localizada na parte inferior do painel do Explorer). Certifique-se de que, no mínimo, os editores abertos e nenhuma pasta aberta exibam os cabeçalhos .

Código do Visual Studio exibe um botão que lê "Abrir pasta". Clique neste botão e selecione uma pasta de sua escolha. O Código do Visual Studio será atualizado e o nome da pasta selecionada substituirá o nome da exibição "Nenhuma pasta aberta". Todas as pastas e arquivos existentes na pasta selecionada serão exibidos abaixo do nome da tela.

Agora abra o arquivo de configurações de preferências de código do Visual Studio . Existem diversas formas de fazer isto. Usarei o mais fácil para lembrar qual é o menu Arquivo → Preferências → Configurações. O arquivo de configurações é exibido em duas colunas. A coluna esquerda é uma lista somente leitura dos valores padrão para todos os recursos do Visual Studio Code. A coluna da direita é usada para listar os três (3) tipos de configurações do usuário. Nesse ponto do teste, apenas duas configurações do usuário serão listadas - Configurações do usuário e Configurações da área de trabalho. As Configurações do usuário são exibidas por padrão. Isso exibe o conteúdo do seu arquivo .json das configurações do usuário. Para descobrir onde esse arquivo está localizado, basta passar o mouse sobre a lista "Configurações do usuário" que aparece na exibição OPEN EDITORS no Explorer. Esta listagem na tela OPEN EDITORS é selecionada automaticamente quando a opção "User Settings" na coluna da direita é selecionada. O caminho deve ser:

C:\Users\%username%\AppData\Roaming\Code\User\settings.json

Esse arquivo settings.json é o local em que as configurações do usuário do código do Visual Studio são armazenadas.

Agora clique na opção Configurações da área de trabalho na coluna direita da lista Preferências. Quando você faz isso, uma subpasta chamada ".vscode" é criada automaticamente na pasta que você adicionou ao Explore, há algumas etapas atrás. Veja a lista da sua pasta no Explorer para confirmar que a subpasta .vscode foi adicionada. Dentro da nova subpasta .vscode, há outro arquivo settings.json. Este arquivo contém as configurações da área de trabalho para a pasta que você adicionou ao Explorer algumas etapas atrás.

Neste ponto, você tem uma única pasta cujas configurações do usuário estão armazenadas em:

C:\Users\%username%\AppData\Roaming\Code\User\settings.json

e cujas configurações da área de trabalho estão armazenadas em:

C:\TheLocationOfYourFolder\settings.json

Essa é a configuração quando uma única pasta é adicionada a uma nova instalação do Visual Studio Code. As coisas ficam confusas quando adicionamos uma segunda pasta (ou superior). Isso ocorre porque estamos alterando as configurações de usuário e de espaço de trabalho do código do Visual Studio para acomodar várias pastas. Em um ambiente de pasta única, apenas dois arquivos settings.json são necessários, conforme listado acima. Porém, em um ambiente com várias pastas, uma subpasta .vscode é criada em cada pasta adicionada ao Explorer e um novo arquivo, "workspaces.json", é criado para gerenciar o ambiente com várias pastas. O novo arquivo "workspaces.json" é criado em:

c:\Users\%username%\AppData\Roaming\Code\Workspaces\%workspace_id%\workspaces.json

O "% workspaces_id%" é uma pasta com um nome exclusivo de todos os números.

Na coluna direita de Preferências, agora aparecem três opções de configuração do usuário - Configurações do Usuário, Configurações da Área de Trabalho e Configurações da Pasta. A função das Configurações do usuário permanece a mesma de um ambiente de pasta única. No entanto, o arquivo de configurações atrás das Configurações da Área de Trabalho foi alterado do arquivo settings.json na subpasta .vscode da pasta única para o arquivo workspaces.json localizado no caminho do arquivo workspaces.json mostrado acima. O arquivo settings.json localizado na subpasta .vscode de cada pasta agora é controlado por uma terceira configuração de usuário, Opções de Pasta. Esta é uma lista de seleção suspensa que permite o gerenciamento do arquivo settings.json de cada pasta, localizado na subpasta .vscode de cada pasta. Observe: a subpasta .vscode não será criada nas pastas do explorer recém-adicionadas até que a pasta recém-adicionada tenha sido selecionada pelo menos uma vez na configuração do usuário das opções de pasta.

Observe que o nome da pasta única do Explorer foi alterado para "UNTITLED (WORKSPACE)". Isso indica o seguinte:

1. Um espaço de trabalho com várias pastas foi criado com o nome "UNTITLED (WORKSPACE)
2. O espaço de trabalho é denominado "UNTITLED (WORKSPACE)" para comunicar que o espaço de trabalho ainda não foi salvo como um arquivo de espaço de trabalho exclusivo e separado
3. O espaço de trabalho UNTITLED (WORKSPACE) pode ter pastas adicionadas e removidas, mas funcionará como o ÚNICO ambiente da área de trabalho para o Visual Studio Code

A funcionalidade completa dos espaços de trabalho do Código do Visual Studio é realizada apenas quando um espaço de trabalho é salvo como um arquivo que pode ser recarregado conforme necessário. Isso fornece a capacidade de criar espaços de trabalho exclusivos com várias pastas (por exemplo, projetos) e salvá-los como arquivos para uso posterior! Para isso, selecione o menu Arquivo → Salvar espaço de trabalho comono menu principal e salve a configuração atual da área de trabalho como um arquivo exclusivo da área de trabalho. Se você precisar criar uma área de trabalho "do zero", primeiro salve sua configuração atual da área de trabalho (se necessário) e clique com o botão direito do mouse em cada nome de pasta do Explorer e clique em "Remover pasta da área de trabalho". Quando todas as pastas tiverem sido removidas da área de trabalho, adicione as pastas necessárias para sua nova área de trabalho. Ao terminar de adicionar novas pastas, salve o novo espaço de trabalho como um novo arquivo de espaço de trabalho.

Uma observação importante - o Visual Studio Code não "reverte" para o modo de pasta única quando apenas uma pasta permanece no Explorer ou quando todas as pastas foram removidas do Explorer ao criar um novo espaço de trabalho "do zero". A configuração da área de trabalho com várias pastas que utiliza três preferências do usuário permanece em vigor. Isso significa que, a menos que você siga as instruções no início desta postagem, o Visual Studio Code nunca poderá retornar ao modo de operação de pasta única - ele sempre permanecerá no modo de espaço de trabalho com várias pastas.

Eles o chamam de espaço de trabalho com várias raízes e, com isso, você pode depurar facilmente porque:

"Com áreas de trabalho com várias raízes, o Visual Studio Code procura em todas as pastas arquivos de configuração de depuração launch.json e os exibe com o nome da pasta como sufixo."

Digamos que você tenha um servidor e uma pasta cliente dentro da pasta do aplicativo. Se você quiser depurá-los juntos, sem um espaço de trabalho, será necessário iniciar duas instâncias do Visual Studio Code, uma para servidor, outra para cliente e você precisará alternar entre elas.

Mas agora (1.24) você não pode adicionar um único arquivo a um espaço de trabalho, apenas pastas, o que é um pouco inconveniente .

Portanto, mais uma vez, a lição de não poluir a árvore de origem de um projeto com artefatos que não estão diretamente relacionados a esse projeto está sendo ignorada.

Não é de zero razão para um arquivo de código Visual Estúdio espaço de trabalho (workspaces.json) ou diretório (.vscode) ou qualquer outra coisa para ser colocado na árvore de origem. Poderia facilmente ser colocado nas configurações do usuário.

Pensei que tivéssemos percebido isso há mais de 20 anos, mas parece que algumas lições estão fadadas a serem repetidas.

Embora a pergunta esteja perguntando "o que é um espaço de trabalho?", Sinto que a fonte de confusão é a expectativa de que os espaços de trabalho se comportem mais como "projetos" em outros editores.

Então, para ajudar todas as pessoas que chegaram aqui por causa dessa confusão, eu queria postar o seguinte plugin para o VS Code (não o meu), "Project Manager": https://marketplace.visualstudio.com/items?itemName=alefragnani .gestor de projeto

Possui uma ótima interface para gerenciar (salvar e abrir) projetos de pasta única:

Salvar projetos:

Projetos abertos com a paleta:

Veja o projeto atual na barra de status (clique para abrir a paleta do projeto):

Acesse projetos na barra lateral:

Em maio de 2018, parece que um espaço de trabalho no Visual Studio Code permite que você tenha acesso rápido a projetos diferentes, mas relacionados. Tudo sem ter que abrir uma pasta diferente.

E você também pode ter vários espaços de trabalho. Veja as referências aqui e você terá uma imagem completa:

Referência 1
Referência 2

Se o código do Visual Studio for uma instalação nova;

1. Clique em extensões, procure por "python" e clique em instalar

2. Clique em ver -> explorer Se não houver uma pasta adicionada na área de trabalho (Arquivo-> Adicionar pasta à área de trabalho)

3. Se você deseja usar um ambiente python virtual, clique em Arquivo -> Preferências -> configurações

Clique em "{} abrir configurações JSON", que fica no canto superior direito da janela, e adicione o caminho para o arquivo python.exe, que está no ambiente virtual

{
    "python.pythonPath": "C:\\PathTo\\VirtualENV\\python.exe"
}

4. Inicie um novo terminal e verifique se o interpretador python correto está selecionado

Você já criou um novo diretório e abriu uma nova janela de código do Visual Studio para um projeto de teste ou para um recurso que deseja adicionar ao seu projeto principal? Ok, então você precisa de um espaço de trabalho e alto uso da CPU ...

Eu só queria mencionar um uso comum de áreas de trabalho no Visual Studio Code, além de todas as outras respostas.