Referência: Extensão Microsoft Quantum Development Kit para Visual Studio Code

O Microsoft Quantum Development Kit (QDK) utiliza a funcionalidade padrão do Visual Studio Code (VS Code), juntamente com funcionalidades específicas da linguagem quando se trabalha com ficheiros .qs ou .qasm. Este guia de referência descreve os principais comandos QDK a que pode aceder na Paleta de Comandos VS Code, juntamente com outras funcionalidades e ligações para conteúdos adicionais. Para obter orientações gerais sobre o VS Code, consulte a documentação do VS Code.

A maioria dos comandos da extensão QDK são acessíveis a partir do menu View > Command Palette . Abra a Paleta de Comandos e introduza QDK: para visualizar uma lista filtrada de comandos enquanto estiver num .qsficheiro , .qasm, ou .qsc .

Tip

Você pode criar atalhos de teclado personalizados para comandos do VS Code usando Atalhos de teclado ou Ctrl + K + S. Para obter mais informações, consulte Ligações de chave para código VS.

Comandos

Muitos dos comandos QDK estão relacionados com a escrita e execução de programas Q# e OpenQASM, e só estão disponíveis quando um .qsficheiro , .qasm, ou .qsc está ativo. Outros comandos estão geralmente disponíveis.

Comandos gerais

Comando	Action	Notes	Ação alternativa do usuário
QDK: Criar projeto Q#	Cria um projeto Q# na pasta ativa, incluindo um qsharp.json arquivo de manifesto e uma src subpasta com um arquivo padrão main.qs .	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#.
QDK: Criar um portátil Microsoft Quantum	Abre um exemplo do Jupyter Notebook que executa um programa Q# + Python e envia um trabalho para o Azure Quantum.	Para mais informações sobre o QDK no Jupyter Notebook, consulte Submeta tarefas ao Azure Quantum com o pacote Python do QDK.	N/A
QDK: 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, selecione o ícone do painel Microsoft Quantum (canto inferior esquerdo).	Para obter mais informações sobre conexões do Azure Quantum, consulte Conectar-se ao seu espaço de trabalho do Azure Quantum.	Passe o rato sobre os espaços de trabalho do Quantum e selecione o ícone +.
QDK: Parque infantil QDK aberto	Abre uma pasta online de programas de exemplo de Q# e OpenQASM 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 ficheiro LEIA-ME na pasta exemplo.	N/A
QDK: 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.	Passe o rato sobre o Quantum Workspaces e selecione o ícone de atualização.
QDK: Criar um ambiente virtual Microsoft Quantum Python	Cria uma pasta e instala um ambiente virtual Python com os pacotes selecionados.	Disponível na versão de ambiente de trabalho do VS Code, mas não no VS Code para a Web.	N/A
QDK: Esfera de Bloch	Abre o visualizador da esfera de Bloch.	Para mais informações, veja Como usar o visualizador da esfera de Bloch no QDK.	N/A
QDK: Mostrar Changelog	Abre um changelog em uma nova guia que mostra as atualizações do QDK para a versão atual e todas as versões anteriores.	O changelog também está disponível no repositório QDK GitHub de código aberto.	N/A
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

Comandos disponíveis com base no tipo de ficheiro ativo

Comando	Tipos de ficheiros de programa	Action	Notes	Ação alternativa do usuário
QDK: Mostrar circuito	.qs, .qasm	Apresenta um diagrama de circuito do programa antes de este executar.	Para obter mais informações, consulte Visualizar diagramas de circuitos quânticos.	Selecione a opção de lente de código Circuit no menu junto à operação de entrada ou sobre cada operação definida pelo utilizador no programa.
QDK: Executar arquivo e mostrar histograma	.qs, .qasm	Executa o programa atual e apresenta um histograma dos resultados num novo painel.	Para aceder às opções de ordenação e filtro, 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.
QDK: Obter QIR para o programa QDK atual	.qs, .qasm	Abre o código-fonte QIR para o código atual do Q# ou OpenQASM numa nova janela de edição. Seu programa deve usar o perfil de destino Base, Adaptive RI ou Adaptive RIF para exportar a origem QIR.	Para mais informações sobre QIR, consulte Representação intermédia quântica e o blogue do desenvolvedor QDK.	N/A
QDK: Calcular estimativas de recursos	.qs, .qasm	Invoca a versão incorporada do estimador de recursos.	Para mais informações, consulte Introdução ao estimador de recursos Microsoft Quantum.	N/A
QDK: Ajuda	.qs	Abre uma breve visão geral da extensão QDK no VS Code.	N/A	N/A
QDK: Executar arquivo e mostrar diagrama de circuito	.qs, .qasm	Executa o programa atual e apresenta um circuito do programa com as saídas.	Para obter mais informações, consulte Visualizar diagramas de circuitos quânticos.	N/A
QDK: Mostrar documentação da API	.qs	Abre a documentação da API em um novo painel. Para pesquisar este painel, prima Ctrl + F.	Para mais informações, consulte a referência da API do Q#.	N/A
Depuração: Iniciar depuração	.qs, .qasm, .qsc	Abre o programa atual no depurador.	Para obter mais informações, consulte Depurando e testando seu código quântico.	Prima F5, selecione a opção CodeLens Depurar junto da operação do ponto de entrada ou selecione o ícone Executar no canto superior direito e, em seguida, selecione Iniciar Depuração.
QDK: Executar programa	.qs, .qasm, .qsc	Executa o programa atual no simulador quântico padrão.	Para obter mais informações, consulte Introdução aos programas Q#.	Prima Ctrl + F5, selecione a opção Executar do CodeLens junto à operação de ponto de entrada ou selecione o ícone Executar, no canto superior direito, e, em seguida, selecione Executar.

Vistas dos painéis

Os programas Q# e OpenQASM utilizam as seguintes vistas no painel VS Code:

View	Action
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

Editar código Q# e OpenQASM

A maioria das funcionalidades comuns de edição de código no VS Code também está disponível quando se trabalha com programas Q# e OpenQASM:

• 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 preenchimento, incluindo sugestões sensíveis ao contexto, de membros de espaços de nomes e de membros de tipos.
• Linting - Em arquivos Q#, você configura o linting por projeto no arquivo de manifesto. Para obter mais informações, consulte Trabalhando com projetos Q#.

Para mais informações, consulte o IntelliSense na documentação do VS Code.

Tarefas comuns

As tabelas seguintes listam comandos para tarefas comuns quando se trabalha com a extensão QDK.

Trabalhar com arquivos e projetos Q#

Tarefa	Action	Notes
Criar um novo arquivo Q#	Selecione Arquivo > Novo arquivo > de texto. Guarde o ficheiro com uma extensão .qs.	Se definir Files: Default Language = qsharp, um novo arquivo assumirá automaticamente como padrão a formatação Q#.
Crie um projeto Q#	Numa pasta aberta no Explorador de Ficheiros, selecione QDK: Criar projeto Q# a partir da Paleta de Comandos, ou clique com o botão direito na pasta no Explorador de Ficheiros e selecione Criar projeto Q#.	Para obter mais informações sobre projetos Q#, consulte Trabalhando com projetos Q#.
Criar um ficheiro de exemplo	Num ficheiro .qs ou .qasm em branco, introduza amostras e depois escolha um programa amostra da lista de opções.	Também pode selecionar QDK: Abrir o QDK playground na Paleta de Comandos para abrir uma pasta online de programas de exemplo de Q# e OpenQASM no Explorador de Ficheiros.

Conectar-se ao Azure Quantum

Tarefa	Action	Notes	Ação alternativa do usuário
Conectar-se a um espaço de trabalho do Azure Quantum	Selecione o ícone do painel Microsoft Quantum (canto inferior esquerdo). A partir de Espaços de Trabalho Quânticos, 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 Quantum Workspaces para conectar outro espaço de trabalho. As conexões de espaço de trabalho persistem entre as suas sessões do VS Code.	Na Paleta de Comandos, selecione QDK: Conectar-se 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 mais informações, consulte Submeter trabalhos ao Azure Quantum com o pacote QDK Python.	N/A

Executar programas

Tarefa	Action	Notes	Ação alternativa do usuário
Execute um programa Q# ou OpenQASM no simulador quântico local	Num ficheiro .qs ou .qasm, selecione o ícone Executar no canto superior direito e selecione Executar.	Para obter mais informações sobre o simulador quântico, consulte o Simulador Quântico Esparso.	Pressione Ctrl + F5 ou escolha QDK: Executar arquivo e mostrar histograma ou QDK: Executar arquivo e mostrar diagrama de circuito na Paleta de Comandos, ou escolha a opção Executar lente de código acima da operação do ponto de entrada.
Depurar um programa	Num programa Q# ou OpenQASM, selecione o ícone Executar no canto superior direito e depois escolha Iniciar Depuração.	Para obter mais informações sobre o depurador Q# no VS Code, consulte Depurando e testando seu código quântico.	Pressione F5 ou escolha a lens de código Debug no menu acima da operação do ponto de entrada.
Exibir provedores e destinos em seus espaços de trabalho	Selecione o ícone do painel Microsoft Quantum (canto inferior esquerdo). A partir do Quantum Workspaces, expanda o espaço de trabalho e depois expanda os Providers para ver os fornecedores disponíveis no espaço de trabalho. Expanda um provedor individual para exibir os destinos disponíveis.	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	Num programa Q# ou OpenQASM, escolha um espaço de trabalho, fornecedor e destino. Para submeter o programa atual, selecione a seta ao lado do alvo.	Para mais informações, consulte Submeter trabalhos ao Azure Quantum com a extensão QDK para VS Code.	N/A
Ver resultados do trabalho	Expanda o espaço de trabalho e, em seguida, expanda Tarefas. 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 do mais novo ao mais antigo.	N/A