¿Qué es un 'espacio de trabajo' en Visual Studio Code?
Por ejemplo, Visual Studio Code habla sobre la aplicación de configuraciones a nivel de usuario frente a nivel de espacio de trabajo .
Por un lado,
- podría hacer referencia a un directorio de proyecto que haya abierto; o
- podría referirse a todo lo que ha abierto en una ventana en particular.
La página mencionada anteriormente dice
"Espacio de trabajo: estas configuraciones se almacenan dentro de su espacio de trabajo en una carpeta .vscode y solo se aplican cuando el espacio de trabajo está abierto".
¿Qué es un espacio de trabajo?
Un proyecto que consta de una o más carpetas raíz , junto con todas las configuraciones de Visual Studio Code que pertenecen a ese proyecto. Estas configuraciones incluyen:
- configuraciones que deben aplicarse cuando ese proyecto está abierto
- extensiones recomendadas para el proyecto (útiles 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?
Visual Studio Code no usa el término de manera consistente en la interfaz de usuario (abrí un problema de GitHub para solucionar este problema). A veces se refiere a un espacio de trabajo como se describe anteriormente y otras veces se refiere a un espacio de trabajo como un proyecto específicamente asociado con un .code-workspace
archivo.
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, a los proyectos con un .code-workspace
archivo se les asigna el sufijo "Espacio de trabajo", lo que contradice el título e indica que sólo esos archivos son en realidad espacios de trabajo.
¿Qué es un .code-workspace
archivo?
Es 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 pertenecientes a un espacio de trabajo.
¿ Necesito un .code-workspace
archivo?
Solo si estás creando un espacio de trabajo con múltiples raíces , en cuyo caso tendrás un único .code-workspace
archivo que restaura automáticamente todas las configuraciones del espacio de trabajo, además de todas las carpetas raíz que deseas que se muestren en el Explorador .
¿Qué pasa con los proyectos de una sola carpeta?
Todo está automatizado.
Cuando abre una carpeta en Visual Studio Code y comienza a realizar modificaciones en el editor que están específicamente relacionadas con el proyecto en el que está trabajando actualmente, Visual Studio Code crea automáticamente una .vscode
carpeta y la almacena en la raíz de la carpeta del proyecto que está Estamos trabajando en. Esta .vscode
carpeta tiene archivos que almacenan los cambios que realizó.
Por ejemplo, si cambia la configuración de Visual Studio Code que desea aplicar solo a su proyecto actual, Visual Studio Code crea un settings.json
archivo con esas actualizaciones y ese archivo se almacena en la .vscode
carpeta.
Puede crear un .code-workspace
archivo que incluya solo una 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 se me ocurre ninguna razón por la que esto sería beneficioso.
¿ Cómo creo un .code-workspace
archivo?
Vaya al menú Archivo → Guardar espacio de trabajo como...
¿Cómo agrego carpetas raíz a un espacio de trabajo?
Vaya al menú Archivo → Agregar carpeta al espacio de trabajo ....
¿Cómo abro un espacio de trabajo definido por un .code-workspace
archivo?
Vaya al menú Archivo → Abrir espacio de trabajo ....
Alternativamente, haga doble clic en el .code-workspace
archivo. Visual Studio Code no abre el archivo real. En cambio, leerá ese archivo y abrirá las carpetas que pertenecen a ese espacio de trabajo.
¿ Cómo veo el .code-workspace
archivo real?
Vaya al menú Archivo → Abrir... y seleccione el .code-workspace
archivo de destino.
Alternativamente, abra el espacio de trabajo asociado con ese archivo. Luego abra la paleta de comandos , busque y seleccione el comando Espacios de trabajo: Abrir archivo de configuración del espacio de trabajo .
Puede guardar la configuración a 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, simplemente abra una carpeta.
Un espacio de trabajo de Visual Studio Code es una lista de las carpetas y archivos de un proyecto. Un espacio de trabajo puede contener varias carpetas. Puede personalizar la configuración y las preferencias de un espacio de trabajo.
Un espacio de trabajo es solo un archivo de texto con una extensión (.code-workspace). Puedes verlo abriéndolo con un editor de texto. Yo también me sentí frustrado por la idea de un espacio de trabajo y cómo se implementa en Visual Studio Code. Encontré un método que me conviene.
Comience con una única carpeta de "proyecto".
Abra Visual Studio Code y cierre todos los espacios de trabajo, archivos o carpetas abiertos. Deberías ver sólo "EDITORES ABIERTOS" y "NO HAY CARPETA ABIERTA" 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. Ponle el nombre que quieras y luego haz clic en "Seleccionar carpeta" . Aparecerá en el explorador de *Visual Studio Code.
Ahora desde el 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 "espacio de trabajo de Visual Studio Code".
Se guardará como un .code-workspace
archivo ( ) y es solo un índice de todos los archivos y carpetas que contiene (o a los que apunta) dondequiera que estén en su disco duro. Puedes verlo abriéndolo con un editor de texto. Cierre la carpeta que creó y cierre Visual Studio Code.
Ahora busque el "archivo" de su espacio de trabajo y haga doble clic en él. Esto abrirá Visual Studio Code con la carpeta que creó en su espacio de trabajo. O puede abrir Visual Studio Code y usar "Abrir espacio de trabajo" .
Cualquier carpeta que cree desde su espacio de trabajo de Visual Studio Code estará dentro de su primera carpeta. Si desea agregar más carpetas de nivel superior, créelas primero donde desee y luego use "Agregar al espacio de trabajo ..." desde Visual Studio Code.
El título y la pregunta posterior en el OP parecen reducirse a:
- ¿Qué es un espacio de trabajo en Visual Studio 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 Visual Studio Code y definidas en un .code-workspace
archivo. Al abrir este archivo se abrirá la colección de carpetas automáticamente. Esto se denomina espacio de trabajo "multi-raíz".
El .code-workspace
archivo también define la configuración del espacio de trabajo que utiliza la instancia de Visual Studio Code donde se abre el espacio de trabajo.
Cuando un espacio de trabajo no está definido, es decir, abre una carpeta por sí sola, puede crear "configuraciones del espacio de trabajo" que se guardan en un .vscode\settings.json
archivo en la raíz de esa estructura de carpetas.
Con más detalle:
Visual Studio Code usa la palabra "espacio de trabajo" de manera un poco ambigua en algunos lugares. El primer uso a considerar es lo que se llama un espacio de trabajo multirraíz .
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 Visual Studio Code. No es necesario que estas carpetas compartan carpetas principales; de hecho, ese es el punto, ya que Visual Studio Code 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
archivo (JSON) que contiene la lista de carpetas que se incluirán en el espacio de trabajo y la configuración de Visual Studio Code.
- Espacios de trabajo multiraíz
En cuanto a la configuración del espacio de trabajo...
Cuando abre el menú Archivo → Preferencias → Configuración, se muestra el editor de configuración. Como mínimo deberías ver una pestaña de CONFIGURACIÓN DE USUARIO . Estas son las configuraciones de Visual Studio Code que son universales para su cuenta de usuario en su máquina local. En Windows estos se guardan en formato %APPDATA%\Code\User\settings.json
.
- Ubicaciones de archivos de configuración de Visual Studio Code
Las carpetas individuales (a menudo cada una de las carpetas "raíz" de un espacio de trabajo) pueden tener una .vscode
carpeta con su propio settings.json
archivo. Cuando se abren individualmente, es decir, no como parte de un espacio de trabajo, el contenido de estos settings.json
archivos se presenta en la pestaña CONFIGURACIÓN DEL ESPACIO DE TRABAJO y todas las configuraciones de ese archivo son utilizadas por la instancia de Visual Studio Code en ejecución.
Al abrir un espacio de trabajo con 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 configuradas en el .code-workspace
archivo. En segundo lugar, cualquier carpeta con un settings.json
archivo aparecerá en una nueva pestaña CONFIGURACIÓN DE CARPETA . settings.json
Tenga en cuenta que, cuando se encuentra en un espacio de trabajo con múltiples raíces, solo se utiliza una cantidad limitada de configuraciones de cada carpeta . Le sugiero que abra el enlace de arriba para leer más.
La principal utilidad de un espacio de trabajo (y quizás la única) 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)
Por lo tanto, puede agruparlos en un espacio de trabajo para un proyecto específico en lugar de tener que abrir varias ventanas de carpetas.
Puedes aprender más aqui .