Je n'arrive pas à croire que je pose cette question, mais je n'ai pas pu trouver de définition dans la documentation. Au cas où cela ne serait pas douloureusement évident, je suis (très) nouveau dans Visual Studio Code.
Par exemple, Visual Studio Code parle de l' application de paramètres au niveau de l'utilisateur par rapport au niveau de l'espace de travail .
D'un côté,
- (a) il pourrait faire référence à un répertoire de projet que vous avez ouvert; ou
- (b) il pourrait faire référence à tout ce que vous avez ouvert dans une fenêtre particulière.
La page référencée ci-dessus dit
"Workspace: These settings are stored inside your workspace in a .vscode folder and only apply when the workspace is opened."
visual-studio-code
Nat Kuhn
la source
la source
File --> Open Workspace
, la boîte de dialogue de l'explorateur de fichiers ne me permet pas simplement "d'ouvrir" un dossier, je dois trouver un fichier spécifique. :(Réponses:
Qu'est-ce qu'un espace de travail?
Un projet qui comprend un ou plusieurs dossiers racine, ainsi que toutes les configurations de code Visual Studio qui appartiennent à ce projet. Un "dossier racine" est le répertoire de niveau supérieur d'un système de fichiers. Ces configurations incluent des données telles que:
Pourquoi un espace de travail est-il si déroutant?
Visual Studio Code n'utilise pas le terme de manière cohérente dans l'interface utilisateur (j'ai ouvert un problème GitHub pour résoudre ce problème). Parfois, il fait référence à un espace de travail comme décrit ci-dessus, et d'autres fois, il fait référence à un espace de travail en tant que projet spécifiquement associé à un
.code-workspace
fichier.Un bon exemple est le widget des fichiers récents . Notez dans la capture d'écran liée que tous les projets sont regroupés sous la même rubrique "espaces de travail", ce qui indiquerait que tout ce qui existe est un espace de travail. Mais alors les projets avec un
.code-workspace
fichier reçoivent un suffixe "Workspace", contredisant l'en-tête et indiquant que seuls ces fichiers sont réellement des espaces de travail.Qu'est-ce qu'un
.code-workspace
fichier?Un fichier JSON avec commentaires qui stocke toutes les données de configuration mentionnées ci-dessus, en plus de:
Ai-je besoin d'un
.code-workspace
fichier?Uniquement si vous créez un espace de travail multi-racine . Avec un espace de travail multi-racine, vous disposez d'un seul
.code-workspace
fichier qui ouvre tous les dossiers racine que vous souhaitez afficher dans l' explorateur (c'est-à-dire que vous n'avez pas besoin de continuer à ouvrir plusieurs dossiers manuellement). Et tous les paramètres / configurations de Visual Studio Code que vous souhaitez appliquer à cet espace de travail sont restaurés chaque fois que vous ouvrez ce fichier d'espace de travail.Qu'en est-il des projets à dossier unique?
Tout est automatisé. Lorsque vous ouvrez un dossier dans Visual Studio Code et commencez à apporter des modifications à l'éditeur spécifiquement liées au projet sur lequel vous travaillez actuellement, Visual Studio Code crée automatiquement un
.vscode
dossier et le stocke à la racine du dossier de projet que vous ' re travailler sur. Ce.vscode
dossier contient des fichiers qui stockent les modifications que vous avez apportées. Par exemple, si vous modifiez les paramètres de code Visual Studio que vous souhaitez appliquer uniquement à votre projet actuel, Visual Studio Code crée unsettings.json
fichier avec ces mises à jour et ce fichier est stocké dans le.vscode
dossier.Vous pouvez créer un
.code-workspace
fichier qui ne comprend qu'un seul dossier racine si vous le souhaitez vraiment. Vous pourrez alors soit ouvrir directement le dossier du projet, soit ouvrir le fichier de l'espace de travail. Mais je ne vois aucune raison pour laquelle cela serait bénéfique.Comment créer un
.code-workspace
fichier?Allez dans le menu Fichier → Enregistrer l'espace de travail sous ...
Comment ajouter des dossiers racine à un espace de travail?
Aller au menu Fichier → Ajouter un dossier à l' espace de travail ... .
Comment ouvrir un espace de travail défini par un
.code-workspace
fichier?Double-cliquez sur le
.code-workspace
fichier. Visual Studio Code n'ouvrira pas le fichier réel. Au lieu de cela, il lira ce fichier et ouvrira les dossiers qui appartiennent à cet espace de travail. Sinon, allez au menu Fichier → Ouvrir l' espace de travail ... .Comment afficher le
.code-workspace
fichier réel ?Allez dans le menu Fichier → Ouvrir ... et sélectionnez le
.code-workspace
fichier cible . Vous pouvez également ouvrir l'espace de travail associé à ce fichier, puis ouvrir la palette de commandes , rechercher et sélectionner la commande Espaces de travail: Ouvrir le fichier de configuration de l'espace de travail .la source
.code-workspace
fichier pour un dossier racine unique est qu'il existe certains paramètres (par exemplefiles.associations
) que VSCode n'honorera pas dans un.vscode/settings.json
, mais honorera dans un espace de travail explicite.Vous pouvez enregistrer les paramètres au niveau de l'espace de travail et vous pouvez ouvrir plusieurs dossiers dans un espace de travail. Si vous voulez faire l'une de ces choses, utilisez un espace de travail, sinon, ouvrez simplement un dossier.
Un espace de travail Code Visual Studio est une liste des dossiers et fichiers d'un projet. Un espace de travail peut contenir plusieurs dossiers. Vous pouvez personnaliser les paramètres et les préférences d'un espace de travail.
la source
settings.json
dans un dossier .vscode dans le dossier correspondant. Cependant, si vous voulez plusieurs dossiers dans un espace de travail et des paramètres qui s'appliquent à tous, vous devez utiliser un espace de travail.Un espace de travail est juste un fichier texte avec une extension (.code-workspace). Vous pouvez le regarder en l'ouvrant avec un éditeur de texte. Moi aussi, j'étais frustré par l'idée d'un espace de travail et la façon dont il est implémenté dans Visual Studio Code. J'ai trouvé une méthode qui me convient.
Commencez avec un seul dossier "projet".
Ouvrez Visual Studio Code et fermez tous les espaces de travail, fichiers ou dossiers ouverts. Vous ne devriez voir que "OUVRIR ÉDITEURS" et "AUCUN DOSSIER OUVERT" dans l'EXPLORATEUR.
Dans la barre de menu * → Fichier → Ouvrir le dossier ... . Accédez à l'emplacement où vous souhaitez placer votre dossier et cliquez avec le bouton droit pour ouvrir un nouveau dossier. Nommez-le comme vous voulez, puis cliquez sur "Sélectionner un dossier" . Il apparaîtra dans * l'explorateur de code Visual Studio.
Maintenant , dans le menu Fichier → Enregistrer sous ... Espace de travail . Nommez l'espace de travail et enregistrez-le où vous voulez conserver tous vos espaces de travail (pas nécessairement où se trouvent vos dossiers de projet). J'ai mis tous les miens dans un dossier appelé "espace de travail Visual Studio Code".
Il sera enregistré en tant que
.code-workspace
fichier ( ) et n'est qu'un index de tous les fichiers et dossiers qu'il contient (ou pointe vers) où qu'ils se trouvent sur votre disque dur. Vous pouvez le regarder en l'ouvrant avec un éditeur de texte. Fermez le dossier que vous avez créé et fermez Visual Studio Code.Trouvez maintenant votre "fichier" d'espace de travail et double-cliquez dessus. Cela ouvrira Visual Studio Code avec le dossier que vous avez créé dans votre espace de travail. Ou vous pouvez ouvrir Visual Studio Code et utiliser "Open Workspace" .
Tous les dossiers que vous créez à partir de votre espace de travail Code Visual Studio seront à l'intérieur de votre premier dossier. Si vous souhaitez ajouter d'autres dossiers de niveau supérieur, créez-les d'abord où vous le souhaitez, puis utilisez «Ajouter à l'espace de travail ..» à partir de Visual Studio Code.
la source
Le titre et la question subséquente du PO semblent se résumer à:
Réponse courte:
Un espace de travail est une collection virtuelle de dossiers ouverts simultanément dans VSCode et définis dans un
.code-workspace
fichier. L'ouverture de ce fichier ouvrira automatiquement la collection de dossiers. C'est ce qu'on appelle un espace de travail "multi-racine".Le
.code-workspace
fichier définit également les paramètres de l'espace de travail utilisés par l'instance de VSCode dans laquelle l'espace de travail est ouvert.Lorsqu'un espace de travail n'est pas défini, c'est-à-dire que vous ouvrez un dossier seul, vous pouvez créer des "paramètres d'espace de travail" qui sont enregistrés dans un
.vscode\settings.json
fichier à la racine de cette structure de dossiers.Plus en détail:
VSCode utilise le mot «espace de travail» un peu ambiguë par endroits. La première utilisation à considérer est dans ce qu'on appelle un espace de travail multi-racine .
Un espace de travail multi-racine est un ensemble de dossiers (les "racines") qui sont ouverts collectivement dans une instance de VSCode. Il n'est pas nécessaire que ces dossiers partagent les dossiers parents; en effet, c'est le point puisque VSCode utilise normalement un seul dossier dans la barre latérale de l'Explorateur.
Un espace de travail multi-racine est défini par un
.code-workspace
fichier (JSON) qui contient à la fois la liste des dossiers à inclure dans l'espace de travail et les paramètres VSCode.Concernant ces paramètres d'espace de travail ...
Lorsque vous ouvrez Fichier> Préférences> Paramètres, l'éditeur de paramètres s'affiche. À tout le moins, vous devriez voir un RÉGLAGES UTILISATEUR onglet . Ce sont les paramètres VSCode qui sont universels pour votre compte d'utilisateur sur votre machine locale. Sous Windows, ceux-ci sont enregistrés
%APPDATA%\Code\User\settings.json
.Les dossiers individuels (souvent chacun des dossiers "racine" d'un espace de travail) peuvent avoir un
.vscode
dossier avec leur propresettings.json
fichier. Lorsqu'ils sont ouverts individuellement, c'est-à-dire ne faisant pas partie d'un espace de travail, le contenu de cessettings.json
fichiers est présenté sous l' onglet PARAMÈTRES DE L'ESPACE DE TRAVAIL , et TOUS les paramètres de ce fichier sont utilisés par l'instance VSCode en cours d'exécution.Lors de l'ouverture d'un espace de travail multi-racine, les choses se comportent différemment. Tout d'abord, l' onglet PARAMÈTRES DE L'ESPACE DE TRAVAIL affiche les options définies dans le
.code-workspace
fichier. Deuxièmement, tout dossier contenant unsettings.json
fichier apparaîtra sous un nouvel onglet PARAMÈTRES DES DOSSIERS . Sachez que, dans un espace de travail multi-racine, seul un nombre limité de paramètres de chaque dossiersettings.json
est utilisé. Je vous suggère d'ouvrir le lien ci-dessus pour en savoir plus.la source
settings.json
autre que%APPDATA%\Code\User
? Dans mon cas, lorsque je place ce fichier dans un dossier, certains paramètres ne sont pas appliqués tels qu'ils sont lorsque le fichier se trouve à l'emplacement "par défaut" dans%APPDATA%
.%APPDATA%\Code\User
. Je n'ai rien remarqué qui suggère que l'%APPDATA%
emplacement lui-même est utilisé. code.visualstudio.com/docs/getstarted/…%APPDATA%
s'agit d'un emplacement valide. Il semble que vos tests indiquent que les fichiers de ce dossier fonctionnent?L'utilité principale d'un espace de travail (et peut-être le seul) est de permettre d'ajouter plusieurs dossiers indépendants qui composent un projet. Par exemple:
Vous pouvez donc les regrouper dans un espace de travail pour un projet spécifique au lieu d'avoir à ouvrir plusieurs fenêtres de dossiers.
Vous pouvez en savoir plus ici .
la source
Après enquête, la réponse semble être (a).
Quand je vais changer les paramètres, le fichier de paramètres va dans un répertoire .vscode dans mon répertoire de projet.
la source
Je viens d'installer Visual Studio Code v1.25.1. sur une machine Windows 7 Professional SP1. Je voulais comprendre les espaces de travail en détail, j'ai donc passé quelques heures à comprendre comment ils fonctionnaient dans cette version de Visual Studio Code. J'ai pensé que les résultats de mes recherches pourraient intéresser la communauté.
Tout d'abord, les espaces de travail sont appelés par Microsoft dans la documentation de Visual Studio Code «espaces de travail multi-root». En clair, cela signifie "un environnement de travail multi-dossiers (AKA" root ")." Un espace de travail Visual Studio Code est simplement une collection de dossiers - toute collection que vous désirez, dans l'ordre que vous souhaitez. La collection typique de dossiers constitue un projet de développement logiciel. Cependant, une collection de dossiers pourrait être utilisée pour toute autre chose pour laquelle un code logiciel est en cours de développement.
La mécanique derrière la façon dont Visual Studio Code gère les espaces de travail est un peu compliquée. Je pense que le moyen le plus rapide de transmettre ce que j'ai appris est de vous donner un ensemble d'instructions que vous pouvez utiliser pour voir comment les espaces de travail fonctionnent sur votre ordinateur. Je suppose que vous commencez avec une nouvelle installation de Visual Studio Code v1.25.1. Si vous utilisez une version de production de Visual Studio Code, je ne vous recommande pas de suivre mes instructions car vous risquez de perdre tout ou partie de votre configuration de Visual Studio Code existante! Si vous avez déjà un test version de de Visual Studio Code v1.25.1 installée ** et que vous êtes prêt à perdre toute configuration qui existe déjà, les opérations suivantes doivent être effectuées pour rétablir votre code Visual Studio à un nouvel état d'installation:
Supprimez le dossier suivant (s'il existe):
Vous allez ajouter des dossiers à Visual Studio Code pour créer un nouvel espace de travail. Si l'un des dossiers que vous avez l'intention d'utiliser pour créer ce nouvel espace de travail a déjà été utilisé avec Visual Studio Code, veuillez supprimer le sous-dossier ".vscode" (s'il existe) dans chacun des dossiers qui seront utilisés pour créer le nouvel espace de travail .
Lancez Visual Studio Code. Si la page d' accueil s'affiche, fermez-la. Faites de même pour le panneau (un volet horizontal) s'il est affiché. Si vous avez reçu un message indiquant que Git n'est pas installé, cliquez sur "Me le rappeler plus tard". S'il est affiché, fermez également la page de codes "Sans titre" qui a été lancée comme page de codes par défaut. Si le volet Explorateur n'est pas affiché, cliquez sur "Affichage" dans le menu principal, puis cliquez sur "Explorateur" pour afficher le volet Explorateur. À l'intérieur du volet Explorateur, vous devriez voir trois (3) en-têtes de vue - Ouvrir les éditeurs, Aucun dossier ouvert et Plan (situé tout en bas du volet Explorateur). Assurez-vous qu'au minimum, les éditeurs ouverts et aucun en- tête de vue de dossier ouvert ne sont affichés .
Visual Studio Code affiche un bouton qui lit «Ouvrir le dossier». Cliquez sur ce bouton et sélectionnez un dossier de votre choix. Visual Studio Code sera actualisé et le nom du dossier sélectionné aura remplacé le nom de la vue «Aucun dossier ouvert». Tous les dossiers et fichiers qui existent dans votre dossier sélectionné seront affichés sous le nom de la vue.
Ouvrez maintenant le fichier de paramètres des préférences de code de Visual Studio . Il y a plusieurs façons de procéder. Je vais utiliser le plus facile à retenir, qui est le menu Fichier → Préférences → Paramètres. Le fichier de paramètres s'affiche dans deux colonnes. La colonne de gauche est une liste en lecture seule des valeurs par défaut pour chaque fonctionnalité de code Visual Studio. La colonne de droite est utilisée pour répertorier les trois (3) types de paramètres utilisateur. À ce stade de votre test, seuls deux paramètres utilisateur seront répertoriés: Paramètres utilisateur et Paramètres de l'espace de travail. Les paramètres utilisateur sont affichés par défaut. Cela affiche le contenu de votre fichier .json des paramètres utilisateur. Pour savoir où se trouve ce fichier, passez simplement votre souris sur la liste "Paramètres utilisateur" qui apparaît sous la vue OUVRIR ÉDITEURS dans l'explorateur. Cette liste dans la vue OPEN EDITORS est automatiquement sélectionnée lorsque l'option "User Settings" dans la colonne de droite est sélectionnée. Le chemin doit être:
Ce fichier settings.json est où les paramètres utilisateur pour Visual Studio Code sont stockés.
Cliquez maintenant sur l'option Paramètres de l'espace de travail dans la colonne de droite de la liste des préférences. Lorsque vous effectuez cette opération, un sous-dossier nommé ".vscode" est automatiquement créé dans le dossier que vous avez ajouté à Explorer il y a quelques étapes. Examinez la liste de votre dossier dans l'Explorateur pour confirmer que le sous-dossier .vscode a été ajouté. À l'intérieur du nouveau sous-dossier .vscode se trouve un autre fichier settings.json. Ce fichier contient les paramètres de l' espace de travail du dossier que vous avez ajouté à l'Explorateur il y a quelques étapes.
À ce stade, vous avez un seul dossier dont les paramètres utilisateur sont stockés dans:
et dont les paramètres de l'espace de travail sont stockés dans:
Il s'agit de la configuration lorsqu'un seul dossier est ajouté à une nouvelle installation de Visual Studio Code. Les choses deviennent désordonnées lorsque nous ajoutons un deuxième dossier (ou plus). En effet, nous modifions les paramètres utilisateur et les paramètres de l'espace de travail de Visual Studio Code pour prendre en charge plusieurs dossiers. Dans un environnement à dossier unique, seuls deux fichiers settings.json sont nécessaires, comme indiqué ci-dessus. Mais dans un environnement multi-dossiers, un sous-dossier .vscode est créé dans chaque dossier ajouté à l'Explorateur et un nouveau fichier, "workspaces.json", est créé pour gérer l'environnement multi-dossiers. Le nouveau fichier "workspaces.json" est créé à:
Le "% workspaces_id%" est un dossier avec un nom unique composé de tous les nombres.
Dans la colonne de droite Préférences, il apparaît maintenant trois options de paramètres utilisateur - Paramètres utilisateur, Paramètres d'espace de travail et Paramètres de dossier. La fonction des paramètres utilisateur reste la même que pour un environnement à dossier unique. Cependant, le fichier de paramètres derrière les paramètres de l'espace de travail a été modifié du fichier settings.json du sous-dossier .vscode du dossier unique au fichier workspaces.json situé dans le chemin d'accès au fichier workspaces.json illustré ci-dessus. Le fichier settings.json situé dans le sous-dossier .vscode de chaque dossier est désormais contrôlé par un troisième paramètre utilisateur, Options des dossiers. Il s'agit d'une liste déroulante de sélection qui permet la gestion du fichier settings.json de chaque dossier situé dans le sous-dossier .vscode de chaque dossier. Remarque: le sous-dossier .vscode ne sera pas créé dans les dossiers d'exploration nouvellement ajoutés tant que le dossier nouvellement ajouté n'aura pas été sélectionné au moins une fois dans le paramètre utilisateur des options de dossier.
Notez que le nom du dossier unique de l'Explorateur a été changé en "UNTITLED (WORKSPACE)". Cela indique ce qui suit:
La fonctionnalité complète des espaces de travail Visual Studio Code n'est réalisée que lorsqu'un espace de travail est enregistré en tant que fichier pouvant être rechargé selon les besoins. Cela permet de créer des espaces de travail multi-dossiers uniques (par exemple, des projets) et de les enregistrer en tant que fichiers pour une utilisation ultérieure! Pour ce faire, sélectionnez le menu Fichier → Enregistrer l'espace de travail sousdans le menu principal et enregistrez la configuration actuelle de l'espace de travail en tant que fichier d'espace de travail unique. Si vous devez créer un espace de travail "à partir de zéro", enregistrez d'abord votre configuration actuelle de l'espace de travail (si nécessaire), puis cliquez avec le bouton droit sur chaque nom de dossier Explorer et cliquez sur "Supprimer le dossier de l'espace de travail". Lorsque tous les dossiers ont été supprimés de l'espace de travail, ajoutez les dossiers dont vous avez besoin pour votre nouvel espace de travail. Lorsque vous avez terminé d'ajouter de nouveaux dossiers, enregistrez simplement le nouvel espace de travail en tant que nouveau fichier d'espace de travail.
Remarque importante - Visual Studio Code ne "revient" pas en mode dossier unique lorsqu'un seul dossier reste dans l'Explorateur ou lorsque tous les dossiers ont été supprimés d'Explorer lors de la création d'un nouvel espace de travail "à partir de zéro". La configuration de l'espace de travail à dossiers multiples qui utilise trois préférences utilisateur reste en vigueur. Cela signifie que si vous ne suivez pas les instructions au début de ce message, Visual Studio Code ne peut jamais être retourné en mode de fonctionnement à dossier unique - il restera toujours en mode d'espace de travail à dossiers multiples.
la source
Ils l'appellent un espace de travail multi-root , et avec cela, vous pouvez facilement déboguer car:
Supposons que vous ayez un serveur et un dossier client dans votre dossier d'application. Si vous souhaitez les déboguer ensemble, sans espace de travail, vous devez démarrer deux instances de Visual Studio Code, une pour le serveur, une pour le client et vous devez basculer d'avant en arrière.
Mais pour l'instant (1.24), vous ne pouvez pas ajouter un seul fichier à un espace de travail, uniquement des dossiers, ce qui est un peu gênant .
la source
Donc, encore une fois, la leçon de ne pas polluer l'arborescence source d'un projet avec des artefacts qui ne sont pas directement liés à ce projet est ignorée.
Il n'y a aucune raison pour qu'un fichier d'espace de travail Visual Studio Code (workspaces.json) ou un répertoire (.vscode) ou quoi que ce soit soit placé dans l'arborescence source. Il aurait tout aussi bien pu être placé sous vos paramètres utilisateur.
Je pensais que nous avions compris cela il y a plus de 20 ans, mais il semble que certaines leçons soient vouées à être répétées.
la source
Bien que la question demande "qu'est-ce qu'un espace de travail?", Je pense que la source de confusion est l'attente que les espaces de travail devraient se comporter davantage comme des "projets" dans d'autres éditeurs.
Donc, pour aider toutes les personnes qui atterrissent ici à cause de cette confusion, je voulais publier le plugin suivant pour VS Code (pas le mien), "Project Manager": https://marketplace.visualstudio.com/items?itemName=alefragnani .Gestionnaire de projet
Il a une belle interface utilisateur pour gérer (enregistrer et ouvrir) des projets à dossier unique:
Enregistrer les projets:
Ouvrir des projets avec la palette:
Voir le projet en cours dans la barre d'état (cliquez pour ouvrir la palette de projets):
Accéder aux projets dans la barre latérale:
la source
Depuis mai 2018, il semble qu'un espace de travail dans Visual Studio Code vous permet d'avoir un accès rapide à des projets différents mais liés. Le tout sans avoir à ouvrir un dossier différent.
Et vous pouvez également avoir plusieurs espaces de travail. Voir les références ici et vous en aurez une image complète:
Référence 1
Référence 2
la source
Si le code Visual Studio est une nouvelle installation;
Cliquez sur les extensions, recherchez "python" et cliquez sur installer
Cliquez sur Affichage -> Explorateur Si aucun dossier n'a ajouté un dossier à l'espace de travail (Fichier-> Ajouter un dossier à l'espace de travail)
Si vous souhaitez utiliser un environnement python virtuel, cliquez sur Fichier -> Préférence -> paramètres
Cliquez sur "{} open settings JSON" qui se trouve dans le coin supérieur droit de la fenêtre, puis ajoutez le chemin d'accès au fichier python.exe qui se trouve dans l'environnement virtuel
la source
Avez-vous déjà créé un nouveau répertoire et ouvert une nouvelle fenêtre Visual Studio Code pour un projet de test ou pour une fonctionnalité que vous souhaitez ajouter à votre projet principal?D'accord, vous avez donc besoin d'un espace de travail et d'une utilisation élevée du processeur ...
Je voulais juste mentionner une utilisation courante des espaces de travail dans Visual Studio Code en plus de toutes les autres réponses.
la source