Nota
O acesso a esta página requer autorização. Podes tentar iniciar sessão ou mudar de diretório.
O acesso a esta página requer autorização. Podes tentar mudar de diretório.
O Azure Quantum Development Kit (QDK) usa toda a funcionalidade padrão do Visual Studio Code (VS Code), juntamente com recursos específicos do Q# quando você trabalha com .qs arquivos. Este guia de referência descreve todos os comandos QDK que você pode acessar na Paleta de Comandos do VS Code, juntamente com outros recursos e links para conteúdo adicional. Para obter orientações gerais sobre o VS Code, consulte a documentação do VS Code.
Gorjeta
A maioria dos comandos da extensão QDK são acessíveis a partir do menu View > Command Palette . Enquanto estiver em um .qs arquivo, abra a Paleta de Comandos e digite QDK: para exibir uma lista filtrada de comandos.
Comandos
A maioria dos comandos QDK estão relacionados à escrita e execução de programas Q# e só estão disponíveis quando um .qs arquivo está ativo. Outros comandos funcionam em segundo plano e não são acessíveis na Paleta de Comandos.
A tabela a seguir descreve os comandos da extensão QDK que aparecem na Paleta de comandos.
Gorjeta
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.
| Comando | Ação | Notas | 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 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 |
| 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, 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 +. |
| QDK: Parque infantil QDK aberto | 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 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. | No Explorador de Arquivos, passe o mouse sobre Quantum Workspaces 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 .qs arquivo está ativo.
| Comando | Ação | Notas | Ação alternativa do usuário |
|---|---|---|---|
| QDK: 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 Circuit no menu junto à operação de entrada ou sobre cada operação definida pelo utilizador no programa. |
| QDK: Executar arquivo e mostrar histograma | Executa o programa Q# atual e exibe um histograma dos resultados em um novo painel. | 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. |
| QDK: Obter QIR para o programa QDK 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, Adaptive RI ou Adaptive RIF 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 |
| QDK: 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 |
| QDK: 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 |
| QDK: 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 |
| QDK: Adicionar arquivo de instruções Copilot para Q# e OpenQASM | Abre um prompt que lhe dá a opção de adicionar instruções do Copilot para ajudá-lo a escrever e executar o código Q# anf OpenQASM. | Para obter mais informações, consulte Configurar o modo de agente no VS Code para o Quantum Development Kit. | N/A |
| QDK: Mostrar documentação da API | Abre a documentação da API em um novo painel. Para pesquisar este painel, prima Ctrl + F. | Para obter mais informações, consulte a referência da API do Azure Quantum. | 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 |
| Depuração: Iniciar depuração | Abre o programa Q# atual no depurador. | Para obter mais informações, consulte Depurando e testando seu código quântico. | Pressione F5 ou selecione a opção de lente de código Depurar no menu ao lado da operação do ponto de entrada ou selecione o ícone Executar no canto superior direito e escolha Iniciar Depuração. |
| Depurar: Executar | Executa o programa Q# atual no simulador quântico padrão. | Para obter mais informações, consulte Introdução aos programas Q#. | Pressione Ctrl + F5 ou selecione a opção de lente de código Executar no menu ao lado da operação do ponto de entrada ou selecione o ícone Executar no canto superior direito e escolha Executar. |
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 de pré-compilação |
Editar código Q#
A maioria dos recursos comuns de edição de código no VS Code também estão disponíveis quando você trabalha com programas Q#:
- 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, incluindo reconhecimento de contexto, membro de namespace e completações de membro de tipo.
- 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 obter mais informações, consulte Intellisense na documentação do VS Code.
Tarefas comuns
Trabalhar com arquivos e projetos Q#
| Tarefa | Ação | Notas |
|---|---|---|
| Novo arquivo Q# | Selecione Arquivo > Novo arquivo > de texto. Salve o arquivo com uma .qs extensão. |
Se definir Files: Default Language = qsharp, um novo arquivo assumirá automaticamente como padrão a formatação Q#. |
| 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 em branco .qs , insira exemplos e selecione um programa de exemplo na lista de opções. |
Você também pode selecionar Abrir playground QDK na Paleta de Comandos para abrir uma pasta online de programas de exemplo Q# no Explorador de Arquivos. |
Conectar-se ao Azure Quantum
| Tarefa | 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 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 obter mais informações, consulte Enviando Python com trabalhos Q# para o Azure Quantum. | N/A |
Executar programas
| Tarefa | 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. | 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 | Em um programa Q#, selecione o ícone Executar no canto superior direito e 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 | No Explorador de Ficheiros, selecione Espaços de Trabalho Quânticos, expanda a área 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. | 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 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 |