Referência: Microsoft Quantum Development Kit ramal para Visual Studio Code

O Microsoft Quantum Development Kit (QDK) usa a funcionalidade padrão de Visual Studio Code (VS Code), juntamente com recursos específicos do idioma quando você trabalha com .qs ou .qasm arquivos. Este guia de referência descreve os principais QDK comandos na VS Code Paleta de Comandos, juntamente com outros recursos e links para mais conteúdo. Para obter diretrizes gerais VS Code , consulte a VS Code documentação.

Para localizar QDK comandos, selecione Exibir > Paleta de Comandos e insira QDK: ou Microsoft Quantum:. Alguns comandos aparecem somente quando um arquivo compatível ou modo de exibição compatível está ativo.

Dica

Crie atalhos de teclado personalizados para os comandos VS Code usando atalhos de teclado ou pressionando Ctrl + K + S. Para obter mais informações, consulte Key Bindings for VS Code.

Commands

Muitos QDK comandos para escrita e execução de Q# e OpenQASM programas só estão disponíveis quando um arquivo .qsc, .qs ou .qasm está ativo. Outros comandos estão sempre disponíveis.

Comandos gerais

Command	Action	Observações	Ação alternativa do usuário
QDK: criar Q# projeto	Cria um Q# projeto 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 Q# projetos, consulte Como trabalhar com Q# projetos.	No Explorador de Arquivos, abra o menu de atalho para a pasta de destino e selecione Criar Q# projeto.
QDK: Criar um Microsoft Quantum notebook	Abre um Notebook de exemplo Jupyter que executa um programa Q# + Python e envia um trabalho para Azure Quantum.	Para obter mais informações sobre o QDK no Jupyter Notebook, consulte Enviar trabalhos para Azure Quantum com o pacote QDKPython.	N/A
QDK: conecte-se a um Azure Quantum espaço de trabalho	Conecta-se a um Azure Quantum espaço de trabalho usando sua conta do Azure ou uma cadeia de conexão. Depois de autenticado, selecione o Microsoft Quantum ícone na Barra de Atividades.	Para obter mais informações sobre conexões Azure Quantum, consulte Conectar-se ao seu Azure Quantum workspace.	Passe o mouse sobre Quantum Workspaces e selecione o ícone +.
QDK: abra o QDK playground	Abre uma pasta online de Q# e OpenQASM programas de exemplo no Explorador de Arquivos. Edite e execute os programas no simulador quântico local e defina pontos de interrupção e percorra o código com o depurador interno.	Para obter mais informações, consulte o arquivo README na pasta de exemplo.	N/A
QDK: Atualizar Azure Quantum espaços de trabalho	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 workspace.	Passe o cursor sobre Quantum Workspaces e selecione o ícone de atualização.
QDK: criar um Microsoft QuantumPython ambiente virtual	Cria uma pasta e instala um ambiente virtual Python com os pacotes selecionados.	Disponível no desktop VS Code, mas não VS Code para a Web.	N/A
QDK: esfera de Bloch	Abre o visualizador da esfera de Bloch.	Para obter mais informações, consulte Como usar o visualizador de esfera de Bloch no QDK.	N/A
QDK: Exibir registro de alterações	Abre um registro de alterações em uma nova guia que mostra as QDK atualizações para a versão atual e todas as versões anteriores.	O registro de alterações também está disponível no QDK repositório open-source no GitHub.	N/A
Microsoft Quantum: Foco na Exibição de Espaços de Trabalho Quânticos	Abre a barra lateral Microsoft Quantum e foca a exibição Quantum Workspaces.	Se nenhum workspace estiver conectado, o modo de exibição fornecerá uma opção para se conectar a um workspace existente. Para obter mais informações, consulte Conectar-se ao seu Azure Quantum workspace.	Selecione o Microsoft Quantum ícone na Barra de Atividades e expanda Quantum Workspaces.
Microsoft Quantum: Foco em QDK Learning Visualização	Abre a barra lateral Microsoft Quantum e foca na visualização de boas-vindas QDK Learning, onde você pode selecionar Iniciar aprendizado.	Disponível na área de trabalho VS Code antes de inicializar QDK Learning no workspace. Para obter mais informações, consulte visão geral do QDK Learning.	Selecione o Microsoft Quantum ícone na Barra de Atividades e expanda QDK Learning.
Microsoft Quantum: Foco no Modo de Exibição de Aprendizagem	Abre a barra lateral Microsoft Quantum e foca na visualização de aprendizado, onde você pode acessar os cursos e continuar seu progresso.	Disponível na área de trabalho VS Code após inicializar QDK Learning no workspace. Para obter mais informações, consulte visão geral do QDK Learning.	Selecione o Microsoft Quantum ícone na Barra de Atividades e expanda o Aprendizado.

Comandos disponíveis com base no tipo de arquivo ativo

Command	Tipos de arquivo de programa	Action	Observações	Ação alternativa do usuário
QDK: mostrar circuito	.qs, .qasm	Mostra um diagrama de circuito para o programa antes de sua execução.	Para obter mais informações, consulte Visualizar diagramas de circuitos quânticos.	Selecione a opção de lente do 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.
QDK: execute o arquivo e mostre o histograma	.qs, .qasm	Executa o programa atual e mostra um histograma dos resultados em um novo painel.	Para acessar as opções de classificação e filtro, selecione o ícone de filtro no painel histograma.	Selecione a opção de lente de código Histograma no menu ao lado da operação do ponto de entrada.
QDK: Obtenha QIR para o programa QDK atual	.qs, .qasm	Abre o código-fonte QIR do código atual Q# ou OpenQASM em uma nova janela de edição. Seu programa deve usar o perfil de destino Base, Adaptive RI ou Adaptive RIF para exportar o código-fonte QIR.	Para obter mais informações sobre QIR, consulte a Quantum intermediate representation e o blog do QDK desenvolvedor.	N/A
QDK: calcular estimativas de recursos	.qs, .qasm	Executa a versão incorporada do estimador de recursos. A VS Code extensão usa uma versão preterida do avaliador de recursos.	Para obter mais informações, consulte Introdução ao Microsoft Quantum avaliador de recursos.	N/A
QDK: Ajuda	.qs	Abre uma breve visão geral da QDK extensão em VS Code.	N/A	N/A
QDK: executar o arquivo e mostrar o diagrama de circuito	.qs, .qasm	Executa o programa atual e mostra um diagrama de circuito do programa com saídas.	Para obter mais informações, consulte Visualizar diagramas de circuitos quânticos.	N/A
QDK: mostrar a documentação da API	.qs	Abre a documentação da API em um novo painel. Para pesquisar esse painel, pressione Ctrl + F.	Para obter mais informações, consulte a referência de Q# API.	N/A
Depuração: Iniciar Depuração	.qs, .qasm, .qsc	Abre o programa atual no depurador.	Para obter mais informações, consulte Depuração e teste de seu código quântico.	Pressione F5, selecione a opção do CodeLens Depurar ao lado da operação de ponto de entrada, ou selecione o ícone Executar no canto superior direito e, em seguida, selecione Iniciar Depuração.
QDK: executar o programa	.qs, .qasm, .qsc	Executa o programa atual no simulador quântico padrão.	Para obter mais informações, consulte Introdução a programas Q#.	Pressione Ctrl + F5, selecione a opção do CodeLens Executar ao lado da operação de ponto de entrada ou selecione o ícone Executar no canto superior direito e, em seguida, selecione Executar.

Visualizações do painel

Os programas Q# e OpenQASM usam as seguintes exibições no painel VS Code:

View	Action
Console de depuração	Mostra a saída de execução ou a saída de depuração
Problemas	Mostra verificações de erro de pré-compilação

Editar código Q# e OpenQASM

Os recursos de edição de código mais comuns em VS Code também estão disponíveis para programas OpenQASM e Q#:

• Verificações de erro de pré-compilação
• Definição de go-to
• References
• Assinaturas de função
• Informação de parâmetro
• Sugestões de autocompletar, incluindo autocompletar com reconhecimento de contexto, membro de namespace e membro de tipo
• Linting. Para arquivos Q#, configure a verificação de código por projeto no arquivo de manifesto. Para obter mais informações, consulte Como trabalhar com Q# projetos.

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

Tarefas comuns

As tabelas a seguir listam comandos para tarefas comuns na QDK extensão.

Trabalhar com Q# arquivos e projetos

Tarefa	Action	Observações
Criar um novo Q# arquivo	Selecione Arquivo > Novo arquivo > Arquivo de texto. Salve o arquivo com uma .qs extensão.	Se você definir Files: Default Language = qsharp, novos arquivos terão Q# como formatação padrão automaticamente.
Criar um Q# projeto	Em uma pasta aberta no Explorador de Arquivos, selecione QDK: Criar projeto Q# na Paleta de Comandos. Ou abra o menu de atalho da pasta no Explorador de Arquivos e selecione Criar Q# projeto.	Para obter mais informações sobre Q# projetos, consulte Como trabalhar com Q# projetos.
Criar um arquivo de exemplo	Em um arquivo .qasm ou .qs em branco, digite samples e selecione um programa de exemplo na lista.	Você também pode selecionar QDK: Abrir QDK playground na Paleta de Comandos para abrir uma pasta online de Q# e OpenQASM programas de exemplo no Explorador de Arquivos.

Conectar-se a Azure Quantum

Tarefa	Action	Observações	Ação alternativa do usuário
Conectar-se a um Azure Quantum workspace	Selecione o ícone Microsoft Quantum na Barra de Atividades. Em Quantum Workspaces, selecione Conectar-se a 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 Quantum Workspaces para conectar outro workspace. As conexões de workspace persistem entre suas VS Code sessões.	Na Paleta de Comandos, selecione QDK: Conectar-se a um Azure Quantum espaço de trabalho.
Conectar-se programaticamente com um Python programa	Abra o menu de atalho para uma conexão de workspace existente e selecione Copiar Python código para se conectar ao workspace. Cole o código resultante em seu Python programa.	Para obter mais informações, consulte Enviar trabalhos para Azure Quantum com o QDKPython pacote.	N/A

Executar programas

Tarefa	Action	Observações	Ação alternativa do usuário
Executar um programa Q# ou OpenQASM no simulador quântico local	Em um .qs arquivo ou .qasm arquivo, selecione o ícone Executar no canto superior direito e, em seguida, 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 do 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	Em um programa Q# ou OpenQASM, selecione o ícone Executar no canto superior direito e, em seguida, selecione Iniciar Depuração.	Para obter mais informações sobre o Q# depurador no VS Code, consulte Depuração e teste do seu código quântico.	Pressione F5 ou escolha a lente de código Depurar no menu acima da operação de entrada.
Exibir provedores e alvos em suas áreas de trabalho	Selecione o Microsoft Quantum ícone na Barra de Atividades. Em Quantum Workspaces, expanda o espaço de trabalho e, em seguida, expanda Provedores para ver os provedores disponíveis no espaço de trabalho. Expanda um provedor individual para exibir os destinos disponíveis.	Passe o mouse sobre um nome de destino para exibir seu status e tempo de fila antes de enviar um trabalho.	N/A
Enviar um trabalho para Azure Quantum	Com um programa Q# ou OpenQASM aberto, selecione um workspace, um provedor e um destino. Para enviar o programa atual, selecione a seta ao lado do destino.	Para obter mais informações, consulte Enviar trabalhos para Azure Quantum com a extensão QDK para VS Code.	N/A
Exibir resultados do trabalho	Expanda o espaço de trabalho e expanda Jobs. Para abrir a saída do trabalho do Armazenamento do Azure, selecione o ícone de nuvem ao lado do nome do trabalho.	Os trabalhos são listados do mais novo para o mais antigo.	N/A