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 (VS) Code, junto con características específicas de Q#, al trabajar con archivos .qs. Este artículo es una guía de referencia a todos los comandos y características relacionados con Q#, con vínculos a contenido adicional según sea necesario. Para obtener instrucciones generales de VS Code, consulte la documentación de VS Code.
Sugerencia
Se puede acceder a la mayoría de los comandos relacionados con Q# desde el menú Ver > paleta de comandos. Mientras se encuentra en un archivo .qs, seleccione Ctrl-Mayús-P (Cmd-Mayús-P en macOS) y escriba Q# para ver una lista filtrada de comandos.
Para todos los métodos abreviados de teclado de macOS, consulte Métodos abreviados de teclado para macOS.
Comandos
Se puede acceder a la mayoría de los comandos relacionados con Q# desde el menú Ver > paleta de comandos. Seleccione Ctrl-Mayús-P y escriba Q# para ver una lista filtrada de comandos. Algunos comandos solo están disponibles cuando un archivo .qs está activo.
Sugerencia
Puede crear métodos abreviados de teclado personalizados para cualquier comando 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 | Action | Notas | Acción de usuario alternativa |
|---|---|---|---|
| Q#: Crear proyecto de Q# | Crea un proyecto de Q# en la carpeta activa, entre los que se incluyen: * un archivo de manifiesto de qsharp.json * una subcarpeta src con un archivo main.qs predeterminado. |
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#. |
| Q#: 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 |
| Q#: 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 Explorador de archivos, mantenga el puntero sobre las áreas de trabajo de Quantum y seleccione el icono "+". |
| Q#: Abrir área de juegos de Q# | 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 |
| P#: 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 Explorador de archivos, mantenga el puntero sobre las áreas de trabajo de Quantum y seleccione el icono de actualización. |
| Explorador: Enfoque en la vista Á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 archivo .qs está activo.
| Comando | Action | Notas | Acción de usuario alternativa |
|---|---|---|---|
| Q#: Establecimiento del perfil de destino de QIR de Azure Quantum | Establece el QIR, o la representación intermedia cuántica, perfil de destino para los programas de Q#. | Para obtener más información sobre los perfiles de destino, consulte Perfiles de destino. | El perfil de destino actual se muestra en la barra de herramientas inferior. Seleccione el perfil de destino de la barra de herramientas para abrir la lista desplegable de selección. |
| Q#: 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 por encima de cada operación definida por el usuario en el programa. |
| Q#: Ejecutar archivo y mostrar histograma | Ejecuta el programa Q# actual y muestra un histograma de los resultados en el panel derecho. | Para acceder a las opciones de ordenación y filtro de la pantalla 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. |
| Q#: Obtener QIR para el programa de Q# 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 o de ri adaptable para exportar el origen de QIR. | Para obtener más información sobre QIR, consulte Representación intermedia cuántica y el blog para desarrolladores de Q#. | N/D |
| Depuración: Depurar archivo Q# | Abre el programa Q# actual en el depurador. | Para más información, consulte Depuración y prueba del código cuántico. | * Seleccionar F5 * Seleccione la opción Debug de code lens (Depurar ) en el menú situado junto a la operación de punto de entrada. * Seleccione el icono Ejecutar en la esquina superior derecha y seleccione Depurar archivo Q#. |
| Depuración: Ejecución del archivo Q# | 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#. | * Seleccione Ctrl+F5. * Seleccione la opción de lente de código Ejecutar en el menú situado junto a la operación de punto de entrada. * Seleccione el icono Ejecutar en la esquina superior derecha y seleccione Ejecutar archivo Q#. |
| Q#: Calcular 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 |
| Q#: 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 |
| Q#: 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 |
| Q#: Mostrar documentación de API | Abre la documentación de api en un panel nuevo. Busque este panel con Ctrl-F. | Para más información, consulte la referencia de la API de Azure Quantum. | N/D |
Terminales
Los programas de Q# usan dos ventanas de terminal en VS Code:
| Terminal | 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 de Q#
La mayoría de las características comunes de edición de código en VS Code están disponibles al trabajar con programas de Q#. Para obtener más información, consulte IntelliSense en la documentación de VS Code.
- Comprobación de errores de precompilación
- Definición de ir a
- Referencias
- Firmas de función
- Información de parámetros
- Sugerencias de finalización
- Linting: en archivos Q#, configurará linting por proyecto en el archivo de manifiesto. Para obtener más información, vea Trabajar con proyectos de Q#.
Tareas comunes
Trabajar con proyectos y archivos de Q#
| Tarea | Action | Notas |
|---|---|---|
| Nuevo archivo Q# | Seleccione Archivo > nuevo archivo Archivo Archivo > de texto. Guarde el archivo con una extensión .qs. | Si establece Files: Default Language = qsharp, el valor predeterminado de un archivo nuevo es el formato de Q# automáticamente. |
| 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 .qs en blanco, escriba ejemplos y seleccione un programa de ejemplo de la lista. | También puede seleccionar Abrir área de juegos de Q# en la paleta de comandos para abrir una carpeta en línea de programas de ejemplo de Q# en 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 | En Explorador de archivos, expanda Áreas de trabajo de Quantum 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 se conservan entre las sesiones de VS Code. * Para quitar una conexión de área de trabajo, haga clic con el botón derecho en el área de trabajo y seleccione Quitar conexión del área de trabajo. |
En la paleta de comandos, seleccione Conectar 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 | Action | 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 archivo Q#. | Para más información sobre el simulador cuántico, consulte el simulador cuántico disperso. | * Seleccione Ctrl-F5. * En la paleta de comandos, seleccione Q#: Ejecutar archivo y mostrar histograma o Q#: Ejecutar archivo y mostrar diagrama de circuito * Seleccione la opción de lente de código Ejecutar en el menú situado junto a la operación de punto de entrada. |
| Depuración de un programa | En un programa de Q#, seleccione el icono Ejecutar en la esquina superior derecha y seleccione Depurar archivo Q#. | Para obtener más información sobre el depurador de Q# en VS Code, consulte Depuración y prueba del código cuántico. | * Seleccionar F5 * Seleccione la opción Debug de code lens (Depurar ) en el menú situado junto a la operación de punto de entrada. |
| Visualización de proveedores y destinos en las áreas de trabajo | En 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 destinos disponibles. | Nota: Mantenga el puntero sobre un nombre de destino para ver su tiempo de estado y 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 área de trabajo y, a continuación, expanda Trabajos. Para abrir la salida del trabajo desde Azure Storage, seleccione el icono de nube situado junto al nombre del trabajo. | Los trabajos se muestran con la parte superior más reciente. | N/D |