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

El Microsoft Quantum Development Kit (QDK) usa la funcionalidad estándar de Visual Studio Code (VS Code), junto con características específicas del lenguaje cuando se trabaja con archivos .qs o .qasm. En esta guía de referencia se describen los comandos principales 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.

La mayoría de los comandos de la extensión QDK son accesibles desde el menú Ver > paleta de comandos . Abra la paleta de comandos y escriba QDK: para ver una lista filtrada de comandos mientras se encuentra en un .qsarchivo , .qasmo .qsc .

Tip

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.

Órdenes

Muchos de los comandos de QDK están relacionados con la escritura y ejecución de programas Q# y OpenQASM, y solo están disponibles cuando un .qsarchivo , .qasmo .qsc está activo. Otros comandos están disponibles con carácter general.

Comandos generales

Comando Action Notas Acción de usuario alternativa
QDK: Creación de un 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 Microsoft 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 obtener más información sobre el QDK en Jupyter Notebook, consulte Envío de trabajos a Azure Quantum con el paquete de Python QDK. N/A
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, seleccione el icono del panel Microsoft Quantum (inferior izquierda). Para más información sobre las conexiones de Azure Quantum, consulte Conexión al área de trabajo de Azure Quantum. 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 Q# y OpenQASM en el 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/A
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. Mantenga el puntero sobre las áreas de trabajo cuánticas y seleccione el icono de actualización.
QDK: Creación de un entorno virtual de Microsoft Quantum Python Crea una carpeta e instala un entorno virtual Python con los paquetes seleccionados. Disponible en VS Code de escritorio, pero no en VS Code para la Web. N/A
QDK: esfera de Bloch Abre el visualizador de esfera de Bloch. Para obtener más información, vea Cómo usar el visualizador de esfera de Bloch en el QDK. N/A
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/A
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/A

Comandos disponibles en función del tipo de archivo activo

Comando Tipos de archivo de programa Action Notas Acción de usuario alternativa
QDK: Mostrar circuito .qs, .qasm Muestra un diagrama de circuito para el programa 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 .qs, .qasm Ejecuta el programa actual y muestra un histograma de los resultados en un nuevo panel. Para acceder a las opciones de ordenación y filtro, 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 .qs, .qasm Abre el código fuente QIR del Q# actual o del código OpenQASM 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 de Quantum y el blog para desarrolladores de QDK. N/A
QDK: Cálculo de estimaciones de recursos .qs, .qasm Invoca la versión integrada del estimador de recursos. Para obtener más información, consulte Introducción al estimador de recursos de Microsoft Quantum. N/A
QDK: Ayuda .qs Abre una breve introducción a la extensión QDK en VS Code. N/A N/A
QDK: Ejecutar archivo y mostrar diagrama de circuito .qs, .qasm Ejecuta el programa actual y muestra un circuito del programa con salidas. Para más información, consulte Visualización de diagramas de circuitos cuánticos. N/A
QDK: Mostrar documentación de API .qs 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 Q#. N/A
Depuración: Iniciar depuración .qs, , .qasm, .qsc Abre el programa actual en el depurador. Para más información, consulte Depuración y prueba del código cuántico. Presione F5, seleccione la opción Debug code lens ( Depurar ) junto a la operación de punto de entrada, o bien seleccione el icono Ejecutar en la esquina superior derecha y, a continuación, seleccione Iniciar depuración.
QDK: Ejecutar programa .qs, , .qasm, .qsc Ejecuta el programa actual en el simulador cuántico predeterminado. Para obtener más información, consulte Introducción a los programas de Q#. Presione Ctrl + F5, seleccione la opción de lente de código Ejecutar junto a la operación de punto de entrada, o seleccione el icono Ejecutar en la esquina superior derecha y, a continuación, seleccione Ejecutar.

Vistas del panel

Los programas Q# y OpenQASM usan las siguientes vistas en el panel de VS Code:

View Action
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 Q# y OpenQASM

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 Q# y OpenQASM:

  • Comprobación de errores de precompilación
  • Definición del destino
  • References
  • Firmas de funciones
  • Información de parámetros
  • Sugerencias de finalización, incluidas las finalizaciones de miembros de contexto, miembro del espacio de nombres y miembros de tipo.
  • 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

En las tablas siguientes se enumeran los comandos de las tareas comunes cuando se trabaja con la extensión QDK.

Trabajar con proyectos y archivos de Q#

tarea Action Notas
Creación de un 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 el Explorador de archivos, seleccione QDK: Crear proyecto de Q# en la paleta de comandos o haga clic con el botón derecho en la carpeta en el 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#.
Creación de un archivo de ejemplo En un archivo en blanco .qs o .qasm, escriba samples y elija un programa de ejemplo en la lista de opciones. También puede seleccionar QDK: Abrir el área de juegos de QDK en la paleta de comandos para abrir una carpeta en línea de programas de ejemplo Q# y OpenQASM en el Explorador de archivos.

Conexión a Azure Quantum

tarea Action Notas Acción de usuario alternativa
Conexión a un área de trabajo de Azure Quantum Seleccione el icono del panel Microsoft Quantum (parte inferior izquierda). En Áreas de trabajo cuánticas , 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 obtener más información, consulte Envío de trabajos a Azure Quantum con el paquete de Python QDK. N/A

Ejecución de programas

tarea Action Notas Acción de usuario alternativa
Ejecución de un programa Q# o OpenQASM en el simulador cuántico local En un .qs archivo o .qasm , 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 En un programa Q# o OpenQASM, seleccione el icono Ejecutar en la esquina superior derecha y, a continuación, 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. Pulsa F5 o selecciona la lente de código Depurar en el menú situado encima de la operación del punto de entrada.
Ver proveedores y destinos en tus espacios de trabajo Seleccione el icono del panel Microsoft Quantum (parte inferior izquierda). En Á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/A
Envío de un trabajo a Azure Quantum En un programa Q# o OpenQASM, elija un área de trabajo, un proveedor y un destino. Para enviar el programa actual, seleccione la flecha situada junto al destino. Para obtener más información, consulte Envío de trabajos a Azure Quantum con la extensión QDK para VS Code. N/A
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/A
  • Se actualizó por última vez el