Referência: extensão do Kit de Desenvolvimento do Azure Quantum para Visual Studio Code

O QDK (Azure Quantum Development Kit) 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 diretrizes gerais do VS Code, consulte a documentação do VS Code.

Dica

A maioria dos comandos relacionados a Q# pode ser acessada no menu Paleta de Comandos de Exibição>. Enquanto estiver em um arquivo .qs, selecione Ctrl-Shift-P (Cmd-Shift-P no macOS) e insira Q# para exibir 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 a Q# pode ser acessada no menu Paleta de Comandos de Exibição>. Selecione Ctrl-Shift-P e insira Q# para exibir uma lista filtrada de comandos. Alguns comandos só estão disponíveis quando um arquivo .qs está ativo.

Dica

Você pode criar atalhos de teclado personalizados para qualquer comando do VS Code usando Atalhos de Teclado ou Ctrl+K+S. Para obter mais informações, consulte Associações de teclas para VS Code.

Comando	Ação	Observações	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 notebook do Azure Quantum	Abre um Jupyter Notebook de exemplo que executa um programa Q# + Python e envia um trabalho para o Azure Quantum.	Para obter mais informações sobre notebooks do Azure Quantum, consulte Trabalhar com notebooks do Azure Quantum.	N/D
P#: Conectar-se a um workspace do Azure Quantum	Conecte-se a um workspace do Azure Quantum usando sua conta do Azure ou uma cadeia de conexão. Depois de autenticado, seu workspace aparecerá no Explorador de Arquivos no Quantum Workspaces.	Para obter mais informações sobre conexões do Azure Quantum, consulte Conectar-se ao workspace do Azure Quantum.	No Explorador de Arquivos, passe o mouse sobre os espaços de trabalho do Quantum e selecione o ícone "+".
Q#: Abra o playground Q#	Abre uma pasta online de programas de exemplo Q# no Explorador de Arquivos. 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 interno.	Para obter mais informações, consulte o arquivo README na pasta de exemplo.	N/D
P#: Atualizar workspaces do Azure Quantum	Sincroniza as alterações mais recentes de seus workspaces quânticos conectados.	Se houver um problema de conexão, um ícone de alerta será exibido ao lado do nome do workspace.	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 Exibição de Workspaces Quânticos	Abre o Explorador de Arquivos e se concentra em seus workspaces quânticos conectados, se configurados. Se nenhum workspace estiver configurado, você será solicitado a adicionar um workspace existente.	Para obter mais informações sobre conexões do Azure Quantum, consulte Conectar-se ao workspace do Azure Quantum.	N/D

Os comandos a seguir estão disponíveis quando um arquivo .qs está ativo.

Comando	Ação	Observações	Ação alternativa do usuário
P#: Definir o perfil de destino QIR do Azure Quantum	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.
Q#: 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 origem QIR para o código Q# atual em uma nova janela de edição. Seu programa deve usar o perfil de destino de RI Base ou Adaptável 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/D
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 Depurar 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 o 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 Avaliador de Recursos.	Para obter mais informações, consulte Introdução ao Avaliador de Recursos do Azure Quantum.	N/D
Q#: 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/D
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/D
Q#: Mostrar documentação da API	Abre a documentação da API em um novo painel. Pesquise esse painel usando Ctrl-F.	Para obter mais informações, consulte a referência da API do Azure Quantum.	N/D

Terminais

Os programas Q# usam 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 de pré-compilação

Editando o código Q#

A maioria dos recursos comuns de edição de código no VS Code está disponível 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
• Definição de acesso
• Referências
• Assinaturas de função
• Informação de parâmetro
• 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#

Tarefa	Ação	Observações
Novo arquivo Q#	Selecione Arquivo > Novo arquivo > Arquivo de texto. Salve o arquivo com uma extensão .qs.	Se você definir Files: Default Language = qsharp, um novo arquivo será padronizado para 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 amostra	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

Tarefa	Ação	Observações	Ação alternativa do usuário
Conectar-se a um workspace do Azure Quantum	No Explorador de Arquivos, expanda Workspaces do Quantum e selecione Adicionar um workspace existente. Siga os prompts para selecionar uma assinatura e um workspace.	* Você pode se conectar a vários espaços de trabalho. Selecione "+" ao lado de Workspaces da Quantum para conectar outro workspace. As conexões do workspace persistem entre as 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-se a um workspace do Azure Quantum.
Conecte-se programaticamente com um programa Python	Clique com o botão direito do mouse em uma conexão de workspace existente e selecione Copiar código Python para se conectar ao workspace. Cole o código resultante em seu programa Python.	Para obter mais informações, consulte Enviando trabalhos do Python com Q# para o Azure Quantum.	N/D

Executando programas

Tarefa	Ação	Observações	Ação alternativa do usuário
Executar 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 Depurar no menu ao lado da operação do ponto de entrada.
Exibir provedores e destinos em seus workspaces	No Explorador de Arquivos, selecione Workspaces da Quantum, expanda o workspace e expanda Provedores para ver os provedores disponíveis no workspace. Expanda um provedor individual para exibir os destinos disponíveis.	Observação: Passe o mouse sobre um nome de destino para exibir seu Status e Tempo de fila antes de enviar um trabalho.	N/D
Enviar um trabalho para o Azure Quantum	Em um programa Q#, selecione um workspace, um provedor e um 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/D
Exibir 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.	Os empregos são listados com os mais recentes no topo.	N/D