visual-studio-code - tutorial - visual studio code plugins
¿Qué es un ''espacio de trabajo'' en VS Code? (11)
¿Qué es un espacio de trabajo?
Un proyecto VSCode que consta de una o más carpetas raíz, junto con todas las configuraciones de VSCode que pertenecen a ese proyecto. Estas configuraciones incluyen datos como:
- configuraciones que deben aplicarse cuando ese proyecto está abierto
- extensiones recomendadas para el proyecto (útil al compartir los archivos de configuración con colegas)
- configuraciones de depuración específicas del proyecto
¿Por qué un espacio de trabajo es tan confuso?
VSCode no usa el término de forma coherente en la interfaz de usuario (he abierto un
problema de GitHub
para solucionar esto).
A veces se refiere a un espacio de trabajo como se describió anteriormente, y otras veces se refiere a un espacio de trabajo como un proyecto que está asociado específicamente con un archivo
.code-workspace
.
Un buen ejemplo es el
widget de archivos recientes
.
Observe en la captura de pantalla vinculada que todos los proyectos están agrupados bajo el mismo encabezado "espacios de trabajo", lo que indicaría que todo lo que hay es un espacio de trabajo.
Pero luego los proyectos con un archivo
.code-workspace
reciben el sufijo "Workspace", lo que contradice el encabezado e indica que solo esos archivos son realmente espacios de trabajo.
¿Qué es un archivo
.code-workspace
?
Un archivo JSON con comentarios que almacena todos los datos de configuración mencionados anteriormente, además de:
- la ubicación de todas las carpetas raíz que pertenecen a un espacio de trabajo
¿Necesito un archivo
.code-workspace
?
Solo si está creando un
https://code.visualstudio.com/docs/editor/multi-root-workspaces
.
Con un espacio de trabajo de múltiples raíces, tiene un único archivo
.code-workspace
que abre todas las carpetas raíz que desea que se muestren en el
explorer
(es decir, no necesita seguir abriendo varias carpetas manualmente).
Y todas las configuraciones / configuraciones de VSCode que desea aplicar a ese espacio de trabajo se restauran cada vez que abre ese archivo de espacio de trabajo.
¿Qué pasa con los proyectos de una sola carpeta?
Todo esta automatizado.
Cuando abre una carpeta en VSCode y comienza a hacer modificaciones en el editor que están específicamente relacionadas con el proyecto en el que está trabajando actualmente, VSCode crea automáticamente una carpeta
.vscode
y la almacena en la raíz de la carpeta del proyecto en la que está trabajando en.
Esta carpeta
.vscode
tiene archivos que almacenan los cambios que realizó.
Por ejemplo, si
cambia la configuración de VSCode
que desea aplicar solo a su proyecto actual, VSCode crea un archivo
settings.json
con esas actualizaciones, y ese archivo se almacena en la carpeta
.vscode
.
Puede crear un archivo
.code-workspace
que incluya una sola carpeta raíz si realmente lo desea.
Luego podrá abrir la carpeta del proyecto directamente o abrir el archivo del espacio de trabajo.
Pero no puedo pensar en ninguna razón por la cual esto sería beneficioso.
¿Cómo creo un archivo
.code-workspace
?
Vaya a
File > Save Workspace As...
¿Cómo agrego carpetas raíz a un espacio de trabajo?
Vaya a
File > Add Folder to Workspace...
¿Cómo abro un espacio de trabajo definido por un archivo
.code-workspace
?
Haga doble clic en el archivo
.code-workspace
.
VSCode no abrirá el archivo real.
En su lugar, leerá ese archivo y abrirá las carpetas que pertenecen a ese espacio de trabajo.
Alternativamente, vaya a
File > Open Workspace...
¿Cómo veo el archivo
.code-workspace
real?
Vaya a
File > Open...
y seleccione el archivo
.code-workspace
destino.
Alternativamente, abra el espacio de trabajo asociado con ese archivo y luego abra la
paleta de comandos
, busque y seleccione el comando
Workspaces: Open Workspace Configuration File
.
No puedo creer que estoy haciendo esta pregunta, pero no he podido encontrar una definición en la documentación. En caso de que no sea dolorosamente obvio, soy (muy) nuevo en VS Code.
Por ejemplo, VS Code habla sobre la aplicación de la configuración a nivel de usuario frente al nivel del espacio de trabajo .
Por un lado, (a) podría referirse a un directorio de proyecto que ha abierto; o (b) podría referirse a todo lo que ha abierto en una ventana en particular.
La página mencionada anteriormente dice "Espacio de trabajo: esta configuración se almacena dentro de su espacio de trabajo en una carpeta .vscode y solo se aplica cuando se abre el espacio de trabajo".
A partir de mayo de 2018, parece que el espacio de trabajo en VS Code le permite tener acceso rápido a proyectos diferentes pero relacionados.
Todo sin tener que abrir una carpeta diferente.
Y también puede tener múltiples espacios de trabajo.
Vea las referencias aquí y obtendrá una imagen completa:
Referencia 1
referencia 2
AFAIK, la utilidad principal de un espacio de trabajo es permitir agregar múltiples carpetas independientes que componen un proyecto. Por ejemplo:
- WorkspaceProjectX
--- ApiFolder (maybe /usr/share/www/api)
--- DocsFolder (maybe /home/user/projx/html/docs)
--- WebFolder (maybe /usr/share/www/web)
Para que pueda agruparlos en un espacio de trabajo para un proyecto específico en lugar de tener que abrir ventanas de carpetas múltiples.
Puedes aprender más https://code.visualstudio.com/docs/editor/multi-root-workspaces .
Acabo de instalar Visual Studio Code v1.25.1. en una máquina con Windows 7 Professional SP1. Quería comprender los espacios de trabajo en detalle, así que pasé unas horas descubriendo cómo funcionan en esta versión de VS Code. Pensé que los resultados de mi investigación podrían ser de interés para la comunidad.
Primero, los espacios de trabajo son referidos por Microsoft en los documentos de VS Code como "espacios de trabajo de múltiples raíces". En inglés simple, eso significa "un entorno de trabajo de varias carpetas (también conocido como" raíz ")". Un espacio de trabajo de VS Code es simplemente una colección de carpetas: cualquier colección que desee, en el orden que desee. La colección típica de carpetas constituye un proyecto de desarrollo de software. Sin embargo, una colección de carpetas podría usarse para cualquier otra cosa para la cual se está desarrollando el código de software.
La mecánica detrás de cómo VS Code maneja los espacios de trabajo es un poco complicada. Creo que la forma más rápida de transmitir lo que aprendí es dándole un conjunto de instrucciones que puede usar para ver cómo funcionan los espacios de trabajo en su computadora. Supongo que está comenzando con una nueva instalación de VS Code v1.25.1. Si está utilizando una versión de producción de VS Code, ¡NO RECOMIENDO QUE SIGA MIS INSTRUCCIONES PORQUE PUEDE PERDER ALGUNO O TODA SU CONFIGURACIÓN VS CODE EXISTENTE! Si ya tiene instalada una versión de PRUEBA de VS Code v1.25.1 y está dispuesto a perder cualquier configuración que ya exista, debe hacer lo siguiente para revertir su VS Code a un nuevo estado de instalación:
Elimine la siguiente carpeta (si existe):
C:/Users/%username%/AppData/Roaming/Code/Workspaces (where "%username%" is the name of the currently logged-on user)
Agregará carpetas a VS Code para crear un nuevo espacio de trabajo. Si alguna de las carpetas que piensa usar para crear este nuevo espacio de trabajo se ha utilizado previamente con VS Code, elimine la subcarpeta ".vscode" (si existe) dentro de cada una de las carpetas que se usarán para crear el nuevo espacio de trabajo.
Lanzamiento VS Code. Si se muestra la página de bienvenida, ciérrela. Haga lo mismo para el Panel (un panel horizontal) si se muestra. Si recibió un mensaje de que Git no está instalado, haga clic en "Recordarme más tarde". Si se muestra, también cierre la página de códigos "Sin título" que se inició como página de códigos predeterminada. Si el panel Explorador no se muestra, haga clic en "Ver" en el menú principal y luego haga clic en "Explorador" para mostrar el panel Explorador. Dentro del panel del Explorador, debería ver tres (3) encabezados de vista: editores abiertos, sin carpeta abierta y esquema (ubicado en la parte inferior del panel del explorador). ASEGÚRESE DE QUE, COMO MÍNIMO, SE VISUALIZEN LOS EDITORES ABIERTOS Y SIN CARPETA ABIERTA.
VS Code muestra un botón que dice "Abrir carpeta". Haga clic en este botón y seleccione una carpeta de su elección. VS Code se actualizará y el nombre de la carpeta seleccionada habrá reemplazado el nombre de vista "No se abrió la carpeta". Cualquier carpeta y archivo que exista dentro de la carpeta seleccionada se mostrará debajo del nombre Ver.
Ahora abra el archivo de configuración de preferencias del código VS. Hay muchas maneras de hacer esto. Usaré el más fácil para recordar cuál es Archivo> Preferencias> Configuración. El archivo de configuración se muestra en dos columnas. La columna izquierda es una lista de solo lectura de los valores predeterminados para cada función de VS Code. La columna derecha se usa para enumerar los tres (3) tipos de configuraciones de usuario. En este punto de la prueba, solo se enumerarán dos configuraciones de usuario: Configuración de usuario y Configuración del espacio de trabajo. La configuración de usuario se muestra de forma predeterminada. Esto muestra el contenido de su archivo de configuración de usuario .json. Para averiguar dónde se encuentra este archivo, simplemente desplace el mouse sobre la lista "Configuración de usuario" que aparece debajo de la vista EDITORES ABIERTOS en el Explorador. Este listado en la Vista de EDITORES ABIERTOS se selecciona automáticamente cuando se selecciona la opción "Configuración de usuario" en la columna derecha. El camino debe ser:
C:/Users/%username%/AppData/Roaming/Code/User/settings.json
Este archivo settings.json es donde se almacenan las configuraciones de usuario para el código VS.
Ahora haga clic en la opción Configuración del espacio de trabajo en la columna derecha de la lista de Preferencias. Cuando hace esto, se crea automáticamente una subcarpeta llamada ".vscode" en la carpeta que agregó a Explorar hace unos pasos. Mire la lista de su carpeta en el Explorador para confirmar que se ha agregado la subcarpeta .vscode. Dentro de la nueva subcarpeta .vscode hay otro archivo settings.json. Este archivo contiene la configuración del espacio de trabajo para la carpeta que agregó al Explorador hace unos pasos.
En este punto, tiene una sola carpeta cuya Configuración de usuario se almacena en:
C:/Users/%username%/AppData/Roaming/Code/User/settings.json
y cuyas configuraciones de espacio de trabajo se almacenan en:
C:/TheLocationOfYourFolder/settings.json
Esta es la configuración cuando se agrega una sola carpeta a una nueva instalación de VS Code. Las cosas se complican cuando agregamos una segunda (o mayor) carpeta. Esto se debe a que estamos cambiando la configuración de usuario y la configuración del espacio de trabajo de VS Code para acomodar varias carpetas. En un entorno de carpeta única, solo se necesitan dos archivos settings.json como se enumeran anteriormente. Pero en un entorno de múltiples carpetas se crea una subcarpeta .vscode en cada carpeta agregada al Explorador y se crea un nuevo archivo, "workspaces.json", para administrar el entorno de múltiples carpetas. El nuevo archivo "workspaces.json" se crea en:
c:/Users/%username%/AppData/Roaming/Code/Workspaces/%workspace_id%/workspaces.json
El "% workspaces_id%" es una carpeta con un nombre único para todos los números.
En la columna derecha de Preferencias, ahora aparecen tres opciones de configuración del usuario: Configuración del usuario, Configuración del área de trabajo y Configuración de la carpeta. La función de Configuración de usuario sigue siendo la misma que para un entorno de carpeta única. Sin embargo, el archivo de configuración detrás de la Configuración del espacio de trabajo se ha cambiado del archivo settings.json en la subcarpeta .vscode de la carpeta individual al archivo workspaces.json ubicado en la ruta del archivo workspaces.json que se muestra arriba. El archivo settings.json ubicado en la subcarpeta .vscode de cada carpeta ahora está controlado por una tercera configuración de usuario, Opciones de carpeta. Esta es una lista desplegable de selección que permite la administración del archivo settings.json de cada carpeta ubicado en la subcarpeta .vscode de cada carpeta. TENGA EN CUENTA: EL SUBFOLDER .vscode NO SE CREARÁ EN CARPETAS EXPLORER RECIENTEMENTE AGREGADAS HASTA QUE LA CARPETA RECIÉN AGREGADA SE HAYA SELECCIONADO AL MENOS UNA VEZ EN LA CONFIGURACIÓN DE USUARIO DE Opciones de Carpeta.
Observe que el nombre de la carpeta única del Explorador se ha cambiado a "SIN TÍTULO (ESPACIO DE TRABAJO)". Esto indica lo siguiente:
- Se ha creado un espacio de trabajo de múltiples carpetas con el nombre "SIN TÍTULO (ESPACIO DE TRABAJO)
- El espacio de trabajo se denomina "SIN TÍTULO (ESPACIO DE TRABAJO)" para comunicar que el espacio de trabajo aún no se ha guardado como un archivo de espacio de trabajo único e independiente.
- El espacio de trabajo SIN TÍTULO (ESPACIO DE TRABAJO) puede tener carpetas agregadas y eliminadas, pero funcionará como el ÚNICO entorno de espacio de trabajo para el Código VS
La funcionalidad completa de los espacios de trabajo de VS Code solo se realiza cuando un espacio de trabajo se guarda como un archivo que se puede volver a cargar según sea necesario. Esto proporciona la capacidad de crear espacios de trabajo únicos de múltiples carpetas (por ejemplo, proyectos) y guardarlos como archivos para su uso posterior. Para hacer esto, seleccione Archivo> Guardar espacio de trabajo como en el menú principal y guarde la configuración actual del espacio de trabajo como un archivo de espacio de trabajo único. Si necesita crear un espacio de trabajo "desde cero", primero guarde la configuración actual del espacio de trabajo (si es necesario), luego haga clic con el botón derecho en el nombre de cada carpeta del Explorador y haga clic en "Eliminar carpeta del espacio de trabajo". Cuando se hayan eliminado todas las carpetas del espacio de trabajo, agregue las carpetas que necesita para su nuevo espacio de trabajo. Cuando termine de agregar nuevas carpetas, simplemente guarde el nuevo espacio de trabajo como un nuevo archivo de espacio de trabajo.
Una nota importante : VS Code no "revierte" al modo de carpeta única cuando solo queda una carpeta en el Explorador o cuando todas las carpetas se han eliminado del Explorador al crear un nuevo espacio de trabajo "desde cero". La configuración del espacio de trabajo de múltiples carpetas que utiliza tres preferencias de usuario permanece vigente. Esto significa que, a menos que siga las instrucciones al principio de esta publicación, VS Code nunca podrá regresar a un modo de operación de una sola carpeta; siempre permanecerá en modo de espacio de trabajo de múltiples carpetas.
Aunque la pregunta es "¿qué es un espacio de trabajo?", Creo que la fuente de confusión es la expectativa de que los espacios de trabajo deberían comportarse más como "proyectos" en otros editores.
Entonces, para ayudar a todas las personas que aterrizan aquí debido a esta confusión, quería publicar el siguiente complemento para VS Code (no el mío), "Project Manager": https://marketplace.visualstudio.com/items?itemName=alefragnani.project-manager
Tiene una buena interfaz de usuario para administrar (guardar y abrir) proyectos de una sola carpeta:
Guardar proyectos:
Proyectos abiertos con la paleta:
Vea el proyecto actual en la barra de estado (haga clic para abrir la paleta del proyecto):
Acceda a proyectos en la barra lateral:
El título y la pregunta posterior en el OP parecen reducirse a:
- ¿Qué es un espacio de trabajo en VS Code?
- ¿Cómo funcionan las configuraciones del espacio de trabajo?
Respuesta corta:
Un espacio de trabajo es una colección virtual de carpetas abiertas simultáneamente en VSCode y definidas en un archivo
.code-workspace
.
Abrir este archivo abrirá la colección de carpetas automáticamente.
Esto se llama un espacio de trabajo "multi-raíz".
El archivo
.code-workspace
también define la configuración del espacio de trabajo que utiliza la instancia de VSCode donde se abre el espacio de trabajo.
Cuando un espacio de trabajo
no
está definido, es decir, abre una carpeta por sí mismo, puede crear "configuraciones de espacio de trabajo" que se guardan en un archivo
.vscode/settings.json
en la raíz de la estructura de esa carpeta.
Con más detalle:
VSCode usa la palabra "espacio de trabajo" un poco ambiguo en algunos lugares. El primer uso a considerar es en lo que se llama un espacio de trabajo de múltiples raíces .
Un espacio de trabajo de múltiples raíces es un conjunto de carpetas (las "raíces") que se abren colectivamente en una instancia de VSCode. No es necesario que estas carpetas compartan carpetas principales; de hecho, ese es el punto ya que VSCode normalmente usa una sola carpeta en la barra lateral del Explorador.
Un espacio de trabajo de múltiples raíces se define mediante un
.code-workspace
(JSON) que contiene la lista de carpetas que se incluirán en el espacio de trabajo y la configuración de VSCode.
Con respecto a la configuración del espacio de trabajo ...
Cuando abre Archivo> Preferencias> Configuración, se muestra el editor de configuración.
Como mínimo, debería ver una pestaña
CONFIGURACIÓN DEL USUARIO
.
Estas son las configuraciones de VSCode que son universales para su cuenta de usuario en su máquina local.
En Windows, estos se guardan en
%APPDATA%/Code/User/settings.json
.
Las carpetas individuales (a menudo cada una de las carpetas "raíz" en un espacio de trabajo) pueden tener una carpeta
.vscode
con su propio archivo
settings.json
.
Cuando se abre individualmente, es decir, no como parte de un espacio de trabajo, el contenido de estos archivos
settings.json
se presenta en la
pestaña CONFIGURACIÓN DEL ESPACIO DE TRABAJO
, y la instancia VSCode en ejecución utiliza TODAS las configuraciones en ese archivo.
Al abrir un espacio de trabajo de múltiples raíces, las cosas se comportan de manera diferente.
En primer lugar, la
pestaña CONFIGURACIÓN DEL ESPACIO DE TRABAJO
muestra las opciones establecidas en el archivo
.code-workspace
.
En segundo lugar, cualquier carpeta con un archivo
settings.json
aparecerá en una nueva pestaña
CONFIGURACIÓN DE CARPETA
.
Tenga en cuenta que, cuando se encuentra en un espacio de trabajo de varias raíces, solo se utiliza una cantidad limitada de configuraciones de settings.json de cada carpeta.
Le sugiero que abra el enlace de arriba para leer más.
En alguna investigación, la respuesta parece ser (a).
Cuando voy a cambiar la configuración, el archivo de configuración entra en un directorio .vscode en mi directorio de proyecto.
Lo llaman https://code.visualstudio.com/docs/editor/multi-root-workspaces , con lo que puede depurar fácilmente b / c
"Con espacios de trabajo de múltiples raíces, VS Code busca en todas las carpetas los archivos de configuración de depuración de launch.json y los muestra con el nombre de la carpeta como un sufijo".
Supongamos que tiene un servidor y una carpeta de cliente dentro de la carpeta de su aplicación, si desea depurarlos juntos, sin espacio de trabajo debe iniciar 2 vscode, uno para el servidor, uno para el cliente y debe cambiar de un lado a otro.
Pero en este momento (1.24) no puede agregar un solo archivo a las carpetas del espacio de trabajo solamente, lo cual es un poco inconvenient
Puede guardar la configuración en el nivel del espacio de trabajo y puede abrir varias carpetas en un espacio de trabajo. Si desea hacer cualquiera de esas cosas, use un espacio de trabajo; de lo contrario, solo abra una carpeta.
Un espacio de trabajo de VS Code es una lista de las carpetas y archivos de un proyecto. Un espacio de trabajo puede contener múltiples carpetas. Puede personalizar la configuración y las preferencias de un espacio de trabajo.
Si el Código de Visual Studio es una instalación nueva;
-
Haga clic en extensiones, busque "python" y haga clic en instalar
-
Haga clic en ver -> explorador Si en ninguna carpeta se agregó una carpeta al área de trabajo (Archivo-> Agregar carpeta al área de trabajo)
-
Si desea utilizar un entorno virtual de Python, haga clic en Archivo -> Preferencia -> configuración
Haga clic en "{} abrir configuración JSON" que se encuentra en la esquina superior derecha de la ventana, luego agregue la ruta al archivo python.exe que se encuentra en el entorno virtual
{
"python.pythonPath": "C://PathTo//VirtualENV//python.exe"
}
- Inicie una nueva terminal y verifique que esté seleccionado el intérprete de Python correcto
Un espacio de trabajo es solo un archivo de texto con una extensión (.code-workspace). Puede verlo abriéndolo con un editor de texto. Yo también estaba frustrado por la idea de un espacio de trabajo y cómo se implementa en VS Code. Encontré un método que me conviene.
Comience con una sola carpeta de "proyecto".
Abra VSCode y cierre todos los espacios de trabajo o archivos o carpetas abiertos. Debería ver solo "EDITORES ABIERTOS" y "NO SE ABRE LA CARPETA" en el EXPLORADOR. Desde la barra de menú -> Archivo -> Abrir carpeta ... Navegue hasta donde desea colocar su carpeta y haga clic derecho para abrir una nueva carpeta. Póngale el nombre que desee, luego haga clic en "Seleccionar carpeta". Aparecerá en el VS Code EXPLORER.
Ahora desde la barra de menú -> Archivo -> Guardar espacio de trabajo como ... Asigne un nombre al espacio de trabajo y guárdelo donde desee guardar todos sus espacios de trabajo (no necesariamente donde están las carpetas de su proyecto). Puse todo el mío en una carpeta llamada "VS Code workspace".
Se guardará como un archivo (.code-workspace) y es solo un índice de todos los archivos y carpetas que contiene (o señala) donde sea que estén en su disco duro. Puede verlo abriéndolo con un editor de texto. Cierre la carpeta que creó y cierre VS Code.
Ahora encuentre el "archivo" de su espacio de trabajo y haga doble clic en él. Esto abrirá VS Code con la carpeta que creó en su espacio de trabajo. O puede abrir VS Code y usar "Open Workspace".
Cualquier carpeta que cree desde su espacio de trabajo de VS Code estará dentro de su primera carpeta. Si desea agregar más carpetas de nivel superior, créelas primero donde las desee y luego use "Agregar al espacio de trabajo ..." de VS Code.