Referencia: Extensión del Kit de desarrollo de Azure Quantum para Visual Studio Code

El Kit de desarrollo de Azure Quantum (QDK) usa toda la funcionalidad estándar de Visual Studio Code (VS Code), junto con características específicas de Q#, cuando se trabaja con .qs archivos. En esta guía de referencia se describen todos los comandos de QDK a los que puede acceder en la paleta de comandos de VS Code, junto con otras características y vínculos a contenido adicional. Para obtener instrucciones generales de VS Code, consulte la documentación de VS Code.

Sugerencia

La mayoría de los comandos de la extensión QDK son accesibles desde el menú Ver > paleta de comandos . Mientras se encuentra en un .qs archivo, abra la paleta de comandos y escriba QDK: para ver una lista filtrada de comandos.

Comandos

La mayoría de los comandos de QDK están relacionados con la escritura y ejecución de programas de Q#, y solo están disponibles cuando un .qs archivo está activo. Otros comandos funcionan en segundo plano y no son accesibles en la paleta de comandos.

En la tabla siguiente se describen los comandos de la extensión QDK que aparecen en la paleta de comandos.

Sugerencia

Puede crear métodos abreviados de teclado personalizados para comandos de VS Code mediante métodos abreviados de teclado o Ctrl + K + S. Para obtener más información, consulte Enlaces de claves para VS Code.

Comando	Acción	Notas	Acción de usuario alternativa
QDK: Crear proyecto de Q#	Crea un proyecto de Q# en la carpeta activa, incluido un qsharp.json archivo de manifiesto y una src subcarpeta con un archivo predeterminado main.qs .	Para obtener más información sobre los proyectos de Q#, vea Trabajar con proyectos de Q#.	En Explorador de archivos, haga clic con el botón derecho en la carpeta de destino y seleccione Crear proyecto de Q#.
QDK: Creación de un cuaderno de Azure Quantum	Abre un cuaderno de Jupyter Notebook de ejemplo que ejecuta un programa de Q# + Python y envía un trabajo a Azure Quantum.	Para más información sobre los cuadernos de Azure Quantum, consulte Uso de cuadernos de Azure Quantum.	N/D
QDK: Conexión a un área de trabajo de Azure Quantum	Conéctese a un área de trabajo de Azure Quantum mediante su cuenta de Azure o una cadena de conexión. Una vez autenticado, el área de trabajo aparece en Explorador de archivos en Áreas de trabajo cuánticas.	Para más información sobre las conexiones de Azure Quantum, consulte Conexión al área de trabajo de Azure Quantum.	En el Explorador de archivos, mantenga el puntero sobre las áreas de trabajo de Quantum y seleccione el icono + .
QDK: Abrir el área de juegos de QDK	Abre una carpeta en línea de programas de ejemplo de Q# en Explorador de archivos. Puede editar y ejecutar los programas en el simulador cuántico local y también establecer puntos de interrupción y recorrer el código con el depurador integrado.	Para obtener más información, vea el archivo LÉAME en la carpeta de ejemplo.	N/D
QDK: Actualización de áreas de trabajo de Azure Quantum	Sincroniza los cambios más recientes de las áreas de trabajo cuánticas conectadas.	Si hay un problema de conexión, aparece un icono de alerta junto al nombre del área de trabajo.	En el Explorador de archivos, mantenga el puntero sobre Las áreas de trabajo cuánticas y seleccione el icono de actualización.
Explorador: Centrar en la vista de Áreas de trabajo cuánticas	Abre Explorador de archivos y se centra en las áreas de trabajo cuánticas conectadas, si está configurada. Si no hay ninguna área de trabajo configurada, se le pedirá que agregue un área de trabajo existente.	Para más información sobre las conexiones de Azure Quantum, consulte Conexión al área de trabajo de Azure Quantum.	N/D

Los siguientes comandos están disponibles cuando un .qs archivo está activo.

Comando	Acción	Notas	Acción de usuario alternativa
QDK: Mostrar circuito	Muestra un diagrama de circuitos para el programa Q# antes de que se ejecute.	Para más información, consulte Visualización de diagramas de circuitos cuánticos.	Seleccione la opción de lente de código Circuito en el menú situado junto a la operación de punto de entrada o encima de cada operación definida por el usuario en el programa.
QDK: Ejecutar archivo y mostrar histograma	Ejecuta el programa Q# actual y muestra un histograma de los resultados en un nuevo panel.	Para acceder a las opciones de ordenación y filtro para la visualización del histograma, seleccione el icono de filtro en el panel histograma.	Seleccione la opción de lente de código Histograma en el menú situado junto a la operación de punto de entrada.
QDK: Obtener QIR para el programa QDK actual	Abre el origen de QIR para el código Q# actual en una nueva ventana de edición. El programa debe usar el perfil de destino Base, Adaptive RI o Adaptive RIF para exportar el origen QIR.	Para obtener más información sobre QIR, consulte Representación intermedia cuántica y el blog para desarrolladores de Q#.	N/D
QDK: Cálculo de estimaciones de recursos	Invoca la versión integrada del estimador de recursos.	Para más información, consulte Introducción al estimador de recursos de Azure Quantum.	N/D
QDK: Ayuda	Una breve introducción a la extensión QDK en VS Code.	Para obtener documentación completa de Azure Quantum, consulte la documentación de Azure Quantum.	N/D
QDK: Ejecutar archivo y mostrar diagrama de circuito	Ejecuta el programa Q# actual y muestra un circuito del programa con salidas.	Para más información, consulte Visualización de diagramas de circuitos cuánticos.	N/D
QDK: Adición del archivo de instrucciones de Copilot para Q# y OpenQASM	Abre un cuadro de diálogo que le ofrece la opción de agregar instrucciones de Copilot para ayudarle a escribir y ejecutar código de Q# y OpenQASM.	Para obtener más información, consulte Configuración del modo de agente en VS Code para el Kit de desarrollo de Quantum.	N/D
QDK: Mostrar documentación de API	Abre la documentación de api en un panel nuevo. Para buscar en este panel, presione Ctrl + F.	Para más información, consulte la referencia de la API de Azure Quantum.	N/D
QDK: Mostrar registro de cambios	Abre un registro de cambios en una nueva pestaña que muestra las actualizaciones de QDK para las versiones actuales y de todas las versiones anteriores.	El registro de cambios también está disponible en el repositorio de GitHub de QDK de código abierto.	N/D
Depuración: Iniciar depuración	Abre el programa Q# actual en el depurador.	Para más información, consulte Depuración y prueba del código cuántico.	Pulse F5 o seleccione la opción Debug de code lens en el menú ubicado junto a la operación de punto de entrada, o seleccione el icono Ejecutar en la esquina superior derecha y elija Iniciar depuración.
Depuración: Iniciar	Ejecuta el programa Q# actual en el simulador cuántico predeterminado.	Para obtener más información, consulte Introducción a los programas de Q#.	Presione Ctrl + F5, o seleccione la opción de lente de código Ejecutar en el menú junto a la operación de punto de entrada, o seleccione el icono Ejecutar en la esquina superior derecha y luego elija Ejecutar.

Terminales

Los programas de Q# usan dos ventanas de terminal en VS Code:

Terminal	Acción
Consola de depuración	Muestra la salida de ejecución o la salida de depuración
Problemas	Muestra comprobaciones de errores anteriores a la compilación

Edición del código de Q#

La mayoría de las características comunes de edición de código en VS Code también están disponibles cuando se trabaja con programas de Q#:

• Comprobación de errores de precompilación
• Definición del destino
• Referencias
• Firmas de funciones
• Información de parámetros
• Sugerencias de finalización, incluidas las finalizaciones conscientes del contexto, de miembros del espacio de nombres y de miembros de tipos.
• Linting: En archivos Q#, se configura linting por proyecto en un archivo de manifiesto. Para obtener más información, vea Trabajar con proyectos de Q#.

Para obtener más información, consulte IntelliSense en la documentación de VS Code.

Tareas comunes

Trabajar con proyectos y archivos de Q#

Tarea	Acción	Notas
Nuevo archivo Q#	Seleccione Archivo > Nuevo archivo > Archivo de texto. Guarde el archivo con una .qs extensión.	Si establece Files: Default Language = qsharp, un nuevo archivo establece automáticamente el formato de Q#.
Creación de un proyecto de Q#	En una carpeta abierta en Explorador de archivos, seleccione Crear proyecto de Q# en la paleta de comandos o haga clic con el botón derecho en la carpeta en Explorador de archivos y seleccione Crear proyecto de Q#.	Para obtener más información sobre los proyectos de Q#, vea Trabajar con proyectos de Q#.
Archivos de ejemplo	En un archivo en blanco .qs , escriba ejemplos y, a continuación, seleccione un programa de ejemplo en la lista de opciones.	También puede seleccionar Abrir área de juegos de QDK en la paleta de comandos para abrir una carpeta en línea de programas de ejemplo de Q# en el Explorador de archivos.

Conexión a Azure Quantum

Tarea	Acción	Notas	Acción de usuario alternativa
Conexión a un área de trabajo de Azure Quantum	En el Explorador de archivos, expanda Áreas de trabajo cuánticas y seleccione Agregar un área de trabajo existente. Siga las indicaciones para seleccionar una suscripción y un área de trabajo.	Puede conectarse a varias áreas de trabajo. Seleccione + junto a Áreas de trabajo de Quantum para conectar otra área de trabajo. Las conexiones del área de trabajo persisten entre las sesiones de VS Code.	En la paleta de comandos, seleccione QDK: Conectarse a un área de trabajo de Azure Quantum.
Conexión mediante programación con un programa de Python	Haga clic con el botón derecho en una conexión de área de trabajo existente y seleccione Copiar código de Python para conectarse al área de trabajo. Pegue el código resultante en el programa de Python.	Para más información, consulte Envío de trabajos de Python con Q# a Azure Quantum.	N/D

Ejecución de programas

Tarea	Acción	Notas	Acción de usuario alternativa
Ejecución de un programa de Q# en el simulador cuántico local	En un programa de Q#, seleccione el icono Ejecutar en la esquina superior derecha y seleccione Ejecutar.	Para más información sobre el simulador cuántico, consulte el simulador cuántico disperso.	Presione Ctrl + F5, o elija QDK: Ejecutar archivo y mostrar histograma o QDK: Ejecutar archivo y mostrar diagrama de circuito en la paleta de comandos, o elija la opción Ejecutar lente de código encima de la operación de punto de entrada.
Depuración de un programa	Dentro de un programa Q#, seleccione el icono Ejecutar en la esquina superior derecha y luego elija Iniciar depuración.	Para obtener más información sobre el depurador de Q# en VS Code, consulte Depuración y prueba del código cuántico.	Presione F5 o elija la opción Depurar Lens de código en el menú situado encima de la operación de punto de entrada.
Ver proveedores y destinos en tus espacios de trabajo	En el Explorador de archivos, seleccione Áreas de trabajo cuánticas, expanda el área de trabajo y, a continuación, expanda Proveedores para ver los proveedores disponibles en el área de trabajo. Expanda un proveedor individual para ver los objetivos disponibles.	Mantenga el puntero sobre un nombre de destino para ver su Estado y tiempo de cola antes de enviar un trabajo.	N/D
Envío de un trabajo a Azure Quantum	En un programa de Q#, seleccione un área de trabajo, un proveedor y un destino. Para enviar el programa de Q# actual, seleccione la flecha situada junto al destino.	Para más información, consulte Envío de trabajos de Q# a Azure Quantum.	N/D
Visualización de los resultados del trabajo	Expanda el espacio de trabajo y luego expanda Trabajos. Para abrir la salida del trabajo desde Azure Storage, seleccione el icono de nube situado junto al nombre del trabajo.	Los trabajos aparecen de más recientes a más antiguos.	N/D