Referência: Extensão do Azure Quantum Development Kit para Visual Studio Code
O Azure Quantum Development Kit (QDK) usa toda a funcionalidade padrão do Visual Studio (VS) Code, juntamente com recursos específicos do Q# ao trabalhar com arquivos .qs. Este artigo é um guia de referência para todos os comandos e recursos relacionados ao Q#, com links para conteúdo adicional conforme necessário. Para obter orientações gerais sobre o VS Code, consulte a documentação do VS Code.
Gorjeta
A maioria dos comandos relacionados ao Q# pode ser acessada no menu Exibir paleta de comandos.> Enquanto estiver em um arquivo .qs, selecione Ctrl-Shift-P (Cmd-Shift-P no macOS) e digite Q# para visualizar uma lista filtrada de comandos.
Para todos os atalhos de teclado do macOS, consulte Atalhos de teclado para macOS.
Comandos
A maioria dos comandos relacionados ao Q# pode ser acessada no menu Exibir paleta de comandos.> Selecione Ctrl-Shift-P e digite Q# para visualizar uma lista filtrada de comandos. Alguns comandos só estão disponíveis quando um arquivo .qs está ativo.
Gorjeta
Você pode criar atalhos de teclado personalizados para qualquer comando VS Code usando Atalhos de teclado ou Ctrl+K+S. Para obter mais informações, consulte Ligações de chave para código VS.
| Comando | Ação | Notas | Ação alternativa do usuário |
|---|---|---|---|
| Q#: Criar projeto Q# | Cria um projeto Q# na pasta ativa, incluindo: * um arquivo de manifesto qsharp.json * Uma subpasta src com um arquivo main.qs padrão. |
Para obter mais informações sobre projetos Q#, consulte Trabalhando com projetos Q#. | No Explorador de Arquivos, clique com o botão direito do mouse na pasta de destino e selecione Criar projeto Q#. |
| P#: Criar um bloco de anotações do Azure Quantum | Abre um exemplo do Jupyter Notebook que executa um programa Q# + Python e envia um trabalho para o Azure Quantum. | Para obter mais informações sobre blocos de anotações do Azure Quantum, consulte Trabalhar com blocos de anotações do Azure Quantum. | N/A |
| P#: Conectar-se a um espaço de trabalho do Azure Quantum | Conecte-se a um espaço de trabalho do Azure Quantum usando sua conta do Azure ou uma cadeia de conexão. Depois de autenticado, seu espaço de trabalho aparece no Explorador de Arquivos no Quantum Workspaces. | Para obter mais informações sobre conexões do Azure Quantum, consulte Conectar-se ao seu espaço de trabalho do Azure Quantum. | No Explorador de Arquivos, passe o mouse sobre os espaços de trabalho do Quantum e selecione o ícone "+". |
| Q#: Abrir o playground Q# | Abre uma pasta online de programas de exemplo Q# no Explorador de Ficheiros. Você pode editar e executar os programas no simulador quântico local, e também definir pontos de interrupção e percorrer o código com o depurador integrado. | Para obter mais informações, consulte o arquivo LEIA-ME na pasta de exemplo. | N/A |
| P#: Atualizar espaços de trabalho do Azure Quantum | Sincroniza as alterações mais recentes de seus espaços de trabalho quânticos conectados. | Se houver um problema de conexão, um ícone de alerta será exibido ao lado do nome do espaço de trabalho. | No Explorador de Arquivos, passe o mouse sobre os espaços de trabalho do Quantum e selecione o ícone de atualização. |
| Explorer: Foco na visualização de espaços de trabalho quânticos | Abre o Explorador de Arquivos e se concentra em seus espaços de trabalho quânticos conectados, se configurados. Se nenhum espaço de trabalho estiver configurado, você será solicitado a adicionar um espaço de trabalho existente. | Para obter mais informações sobre conexões do Azure Quantum, consulte Conectar-se ao seu espaço de trabalho do Azure Quantum. | N/A |
Os comandos a seguir estão disponíveis quando um arquivo .qs está ativo.
| Comando | Ação | Notas | Ação alternativa do usuário |
|---|---|---|---|
| P#: Definir o perfil de destino do Azure Quantum QIR | Define o perfil de destino QIR, ou representação intermediária quântica, para seus programas Q#. | Para obter mais informações sobre perfis de destino, consulte Perfis de destino. | O perfil de destino atual é exibido na barra de ferramentas inferior. Selecione o perfil de destino na barra de ferramentas para abrir a lista suspensa de seleção. |
| Q#: Mostrar circuito | Exibe um diagrama de circuito para o programa Q# antes de ser executado. | Para obter mais informações, consulte Visualizar diagramas de circuitos quânticos. | Selecione a opção de lente de código Circuito no menu ao lado da operação do ponto de entrada ou acima de cada operação definida pelo usuário no programa. |
| P#: Executar arquivo e mostrar histograma | Executa o programa Q# atual e exibe um histograma dos resultados no painel direito. | Para acessar as opções de classificação e filtro para a exibição do histograma, selecione o ícone de filtro no painel do histograma. | Selecione a opção de lente de código Histograma no menu ao lado da operação do ponto de entrada. |
| Q#: Obter QIR para o programa Q# atual | Abre a fonte QIR para o código Q# atual em uma nova janela de edição. Seu programa deve usar o perfil de destino Base ou Adaptive RI para exportar a origem QIR. | Para obter mais informações sobre QIR, consulte Representação intermediária quântica e o blog do desenvolvedor Q#. | N/A |
| Depurar: Depurar arquivo Q# | Abre o programa Q# atual no depurador. | Para obter mais informações, consulte Depurando e testando seu código quântico. | * Selecione F5 * Selecione a opção de lente de código Debug no menu ao lado da operação do ponto de entrada. * Selecione o ícone Executar no canto superior direito e selecione Depurar arquivo Q#. |
| Depurar: Executar arquivo Q# | Executa o programa Q# atual no simulador quântico padrão. | Para obter mais informações, consulte Introdução aos programas Q#. | * Selecione Ctrl + F5 * Selecione a opção de lente de código Executar no menu ao lado da operação do ponto de entrada. * Selecione o ícone Executar no canto superior direito e selecione Executar arquivo Q#. |
| P#: Calcular estimativas de recursos | Invoca a versão interna do Resource Estimator. | Para obter mais informações, consulte Introdução ao Azure Quantum Resource Estimator. | N/A |
| P#: Ajuda | Uma breve visão geral da extensão QDK no VS Code. | Para obter a documentação completa do Azure Quantum, consulte a documentação do Azure Quantum. | N/A |
| Q#: Executar arquivo e mostrar diagrama de circuito | Executa o programa Q# atual e exibe um circuito do programa com saídas. | Para obter mais informações, consulte Visualizar diagramas de circuitos quânticos. | N/A |
| P#: Mostrar documentação da API | Abre a documentação da API em um novo painel. Pesquise neste painel usando Ctrl-F. | Para obter mais informações, consulte a referência da API do Azure Quantum. | N/A |
Terminais
Os programas Q# fazem uso de duas janelas de terminal no VS Code:
| Terminal | Ação |
|---|---|
| Console de depuração | Exibe a saída de execução ou a saída de depuração |
| Problemas | Exibe verificações de erro pré-compilação |
Editando código Q#
A maioria dos recursos comuns de edição de código no VS Code estão disponíveis ao trabalhar com programas Q#. Para obter mais informações, consulte Intellisense na documentação do VS Code.
- Verificação de erros de pré-compilação
- Ir para a definição
- Referências
- Assinaturas de função
- Informações sobre parâmetros
- Sugestões de conclusão
- Linting - Em arquivos Q#, você configura o linting por projeto no arquivo de manifesto. Para obter mais informações, consulte Trabalhando com projetos Q#.
Tarefas comuns
Trabalhando com arquivos e projetos Q#
| Task | Ação | Notas |
|---|---|---|
| Novo arquivo Q# | Selecione Arquivo > Novo arquivo > de texto. Salve o arquivo com uma extensão .qs. | Se você definir Files: Default Language = qsharpo , um novo arquivo assumirá como padrão a formatação Q# automaticamente. |
| Criar um projeto Q# | Em uma pasta aberta no Explorador de Arquivos, selecione Criar Projeto Q# na Paleta de Comandos ou clique com o botão direito do mouse na pasta no Explorador de Arquivos e selecione Criar projeto Q#. | Para obter mais informações sobre projetos Q#, consulte Trabalhando com projetos Q#. |
| Arquivos de exemplo | Em um arquivo .qs em branco, insira exemplos e selecione um programa de exemplo na lista. | Você também pode selecionar Abrir playground Q# na Paleta de Comandos para abrir uma pasta online de programas de exemplo Q# no Explorador de Arquivos. |
Conectando-se ao Azure Quantum
| Task | Ação | Notas | Ação alternativa do usuário |
|---|---|---|---|
| Conectar-se a um espaço de trabalho do Azure Quantum | No Explorador de Arquivos, expanda Espaços de trabalho quânticos e selecione Adicionar um espaço de trabalho existente. Siga as instruções para selecionar uma assinatura e um espaço de trabalho. | * Você pode se conectar a vários espaços de trabalho. Selecione "+" ao lado de Espaços de trabalho quânticos para conectar outro espaço de trabalho. As conexões de espaço de trabalho persistem entre suas sessões do VS Code. * Para remover uma conexão de espaço de trabalho, clique com o botão direito do mouse no espaço de trabalho e selecione Remover conexão de espaço de trabalho. |
Na Paleta de comandos, selecione Conectar a um espaço de trabalho do Azure Quantum. |
| Conecte-se programaticamente com um programa Python | Clique com o botão direito do mouse em uma conexão de espaço de trabalho existente e selecione Copiar código Python para se conectar ao espaço de trabalho. Cole o código resultante em seu programa Python. | Para obter mais informações, consulte Enviando Python com trabalhos Q# para o Azure Quantum. | N/A |
Programas em execução
| Task | Ação | Notas | Ação alternativa do usuário |
|---|---|---|---|
| Execute um programa Q# no simulador quântico local | Em um programa Q#, selecione o ícone Executar no canto superior direito e selecione Executar arquivo Q#. | Para obter mais informações sobre o simulador quântico, consulte o simulador quântico esparso. | * Selecione Ctrl-F5 * Na Paleta de Comandos, selecione Q#: Executar arquivo e mostrar histograma ou Q#: Executar arquivo e mostrar diagrama de circuito * Selecione a opção de lente de código Executar no menu ao lado da operação do ponto de entrada. |
| Depurar um programa | Em um programa Q#, selecione o ícone Executar no canto superior direito e selecione Depurar arquivo Q#. | Para obter mais informações sobre o depurador Q# no VS Code, consulte Depurando e testando seu código quântico. | * Selecione F5 * Selecione a opção de lente de código Debug no menu ao lado da operação do ponto de entrada. |
| Exibir provedores e destinos em seus espaços de trabalho | No Explorador de Ficheiros, selecione Espaços de trabalho quânticos, expanda o espaço de trabalho e, em seguida, expanda Fornecedores para ver os fornecedores disponíveis na área de trabalho. Expanda um provedor individual para exibir os destinos disponíveis. | Nota: Passe o cursor sobre um nome de destino para visualizar seu Status e Tempo de fila antes de enviar um trabalho. | N/A |
| Enviar um trabalho para o Azure Quantum | Em um programa Q#, selecione um espaço de trabalho, provedor e destino. Para enviar o programa Q# atual, selecione a seta ao lado do destino. | Para obter mais informações, consulte Enviando trabalhos Q# para o Azure Quantum. | N/A |
| Ver resultados do trabalho | Expanda o espaço de trabalho e, em seguida, expanda Trabalhos. Para abrir a saída do trabalho do Armazenamento do Azure, selecione o ícone de nuvem ao lado do nome do trabalho. | As vagas são listadas com as mais recentes no topo. | N/A |