Справочник: расширение пакета средств разработки Azure Quantum для Visual Studio Code

Пакет средств разработки Azure Quantum (QDK) использует все стандартные функции Visual Studio (VS) Code, а также функции Q# для работы с файлами .qs. В этой статье приведено справочное руководство по всем связанным командам и функциям Q# с ссылками на дополнительное содержимое по мере необходимости. Общие рекомендации по VS Code см. в документации по VS Code.

Совет

Большинство команд, связанных с Q#, можно найти в меню командной палитры View. В файле QS выберите CTRL-SHIFT-P (Cmd-SHIFT-P в macOS) и введите Q# для просмотра отфильтрованного списка команд.

Для всех сочетаний клавиш macOS см . сочетания клавиш для macOS.

Команды

Большинство связанных команд Q# можно получить в > команд представления". Нажмите клавиши CTRL-SHIFT-P и введите Q# для просмотра отфильтрованного списка команд. Некоторые команды доступны только в том случае, если файл QS активен.

Совет

Можно создать пользовательские сочетания клавиш для любой команды VS Code с помощью сочетаний клавиш или CTRL+K+S. Дополнительные сведения см. в разделе "Ключевые привязки" для VS Code.

Команда	Действие	Примечания.	Альтернативное действие пользователя
Q#: создание проекта Q#	Создает проект Q# в активной папке, в том числе: * файл манифеста qsharp.json * папка src с файлом main.qs по умолчанию.	Дополнительные сведения о проектах Q# см. в статье "Работа с проектами Q#".	В Проводнике щелкните правой кнопкой мыши целевую папку и выберите команду Создать проект Q#.
Вопрос. Создание записной книжки Azure Quantum	Открывает пример Jupyter Notebook, который запускает программу Q# + Python и отправляет задание в Azure Quantum.	Дополнительные сведения о записных книжках Azure Quantum см. в статье "Работа с записными книжками Azure Quantum".	Н/П
Q#: Подключение к рабочей области Azure Quantum	Подключитесь к рабочей области Azure Quantum с помощью учетной записи Azure или строки подключения. После проверки подлинности ваша рабочая область появится в Проводнике в Quantum Workspaces.	Дополнительные сведения о подключениях Azure Quantum см. в статье "Подключение к рабочей области Azure Quantum".	В Проводнике наведите указатель мыши на рабочие области Quantum и выберите значок "+".
Q#: Открытие игровой площадки Q#	Открывает онлайн-папку примеров программ Q# в Проводнике. Вы можете редактировать и запускать программы в локальном квантовом симуляторе, а также задавать точки останова и выполнять шаги по коду со встроенным отладчиком.	Для получения дополнительной информации смотрите файл README в папке с образцами.	Н/П
Вопрос. Обновление рабочих областей Azure Quantum	Синхронизирует последние изменения из ваших подключенных квантовых рабочих областей.	Если возникла проблема с подключением, рядом с именем рабочей области появится значок оповещения.	В проводник наведите указатель мыши на рабочие области Quantum и щелкните значок обновления.
Обозреватель: фокус на интерфейсе квантовых рабочих областей	Открывает проводник и фокусируется на подключенных квантовых рабочих областях при настройке. Если рабочие области не настроены, вам будет предложено добавить существующую рабочую область.	Дополнительные сведения о подключениях Azure Quantum см. в статье "Подключение к рабочей области Azure Quantum".	Н/П

Следующие команды доступны при активном использовании QS-файла.

Команда	Действие	Примечания.	Альтернативное действие пользователя
Q#: Установите целевой профиль QIR для Azure Quantum	Задает QIR или квантовое промежуточное представление целевого профиля для программ Q#.	Дополнительные сведения о целевых профилях см. в разделе "Целевые профили".	Текущий целевой профиль отображается на нижней панели инструментов. Выберите целевой профиль на панели инструментов, чтобы открыть раскрывающийся список выбора.
Q#: Показать схему	Отображает схему канала для программы Q# перед запуском.	Дополнительные сведения см. в разделе Визуализация схем квантовых каналов.	Выберите опцию Code Lens из меню рядом с операцией точки входа или над каждой пользовательской операцией в программе.
Q#: запуск файла и отображение гистограммы	Запускает текущую программу Q# и отображает гистограмму результатов в правой области.	Чтобы получить доступ к параметрам сортировки и фильтрации для отображения гистограммы, выберите значок фильтра в области гистограммы.	Выберите параметр линзы кода гистограмма в меню рядом с операцией точки входа.
Q#: Получение QIR для текущей программы Q#	Открывает источник QIR для текущего кода Q# в новом окне редактирования. Программа должна использовать профиль целевого объекта Base или Adaptive RI для экспорта источника QIR.	Дополнительные сведения о QIR см. в промежуточном представлении Quantum и блоге разработчика Q#.	Н/П
Отладка файла Q#	Открывает текущую программу Q# в отладчике.	Дополнительные сведения см. в статье отладка и тестирование квантового кода.	* Выберите F5 * Выберите параметр "Отладить" в меню рядом с операцией точки входа. * Выберите значок "Выполнить" в правом верхнем углу и выберите Отладка файла Q#.
Отладка: запуск файла Q#	Запускает текущую программу Q# в квантовом симуляторе по умолчанию.	Дополнительные сведения см. в статье "Начало работы с программами Q#".	* Нажмите клавиши CTRL+F5 * Выберите в меню рядом с точкой входа операцией опцию "Code Lens" и нажмите Выполнить. * Щелкните значок запуска в правом верхнем углу и выберите "Запустить файл Q#".
Q#: вычисление оценок ресурсов	Вызывает встроенную версию средства оценки ресурсов.	Дополнительные сведения см. в статье "Общие сведения о оценке ресурсов Azure Quantum".	Н/П
Q#: Справка	Краткий обзор расширения QDK в VS Code.	Полную документацию по Azure Quantum смотрите в разделе Документация по Azure Quantum.	Н/П
Q#: запуск файла и отображение схемы	Запускает текущую программу Q# и отображает канал программы с выходными данными.	Дополнительные сведения см. в разделе Визуализация схем квантовых каналов.	Н/П
Q#: отображение документации по API	Открывает документацию по API в новой панели. Выполните поиск в этой области с помощью CTRL-F.	Дополнительные сведения см. в справочнике API Azure Quantum.	Н/П

Терминалы

Программы Q# используют два окна терминала в VS Code:

Терминал	Действие
Консоль отладки	Отображает выходные данные выполнения или выходные данные отладки
Проблемы	Отображает проверки ошибок предварительной компиляции

Редактирование кода Q#

Большинство распространенных функций редактирования кода в VS Code доступны при работе с программами Q#. Дополнительные сведения см. в разделе Intellisense документации по VS Code.

• Проверка ошибок предварительной компиляции
• Перейти к определению
• Ссылки
• Подписи функций
• Информация о параметре
• Предложения по завершению, включая контекст, член пространства имен и завершение элементов типа.
• Линтинг — в Q# файлах вы настраиваете проверку кода для каждого проекта в файле manifest. Дополнительные сведения см. в статье "Работа с проектами Q#".

Стандартные задачи

Работа с файлами и проектами Q#

Задача	Действие	Примечания.
Новый файл Q#	Выберите Файл > Новый файл > Текстовый файл. Сохраните файл с расширением QS.	Если задано Files: Default Language = qsharp, новый файл по умолчанию используется для автоматического форматирования Q#.
Создание проекта Q#	В открытой папке в проводник выберите "Создать проект Q#" в палитре команд или щелкните правой кнопкой мыши папку в проводник и выберите "Создать проект Q#".	Дополнительные сведения о проектах Q# см. в статье "Работа с проектами Q#".
Примеры файлов	В пустом файле QS введите примеры, а затем выберите пример программы из списка.	Вы также можете выбрать "Открыть песочницу Q#" в палитре команд, чтобы открыть онлайн-папку с примерами программ Q# в Проводнике.

Подключение к Azure Quantum

Задача	Действие	Примечания.	Альтернативное действие пользователя
Подключение к рабочей области Azure Quantum	В проводнике разверните Quantum рабочие области и выберите Добавить существующую рабочую область. Следуйте инструкциям, чтобы выбрать подписку и рабочую область.	* Вы можете подключиться к нескольким рабочим областям. Выберите "+" рядом с рабочими областями Quantum, чтобы подключить другую рабочую область. Подключения к рабочей области сохраняются между сеансами VS Code. * Чтобы удалить подключение к рабочей области, щелкните правой кнопкой мыши рабочую область и выберите " Удалить подключение к рабочей области".	В палитре команд выберите "Подключиться к рабочей области Azure Quantum".
Программное подключение к программе Python	Щелкните правой кнопкой мыши существующее подключение к рабочей области и выберите " Копировать код Python", чтобы подключиться к рабочей области. Вставьте полученный код в программу Python.	Дополнительные сведения см. в статье "Отправка Python с заданиями Q# в Azure Quantum".	Н/П

Запуск программ

Задача	Действие	Примечания.	Альтернативное действие пользователя
Запуск программы Q# на локальном квантовом симуляторе	В программе Q# выберите значок "Выполнить" в правом верхнем углу и нажмите кнопку "Запустить файл Q#".	Дополнительные сведения о квантовом симуляторе см. в разреженном квантовом симуляторе.	* Выберите CTRL-F5 * В палитре команд выберите Q#: Запустите файл и показать гистограмму или Q#: Запустите файл и показать схему канала * Выберите опцию Запустить в меню рядом с операцией точки входа.
Отладка программы	В программе Q# щелкните значок "Выполнить " в правом верхнем углу и выберите файл "Отладка Q#".	Дополнительные сведения об отладчике Q# в VS Code см. в статье Отладка и тестирование квантового кода.	* Выберите F5 * Выберите опцию "Отладить" из меню рядом с операцией точки входа.
Просмотр поставщиков и целей в ваших рабочих областях	В Проводнике выберите рабочие области Quantum, разверните рабочую область и затем разверните Поставщики, чтобы увидеть доступных поставщиков в рабочей области. Разверните отдельного поставщика, чтобы просмотреть доступные целевые элементы.	Примечание. Наведите указатель мыши на целевое имя, чтобы просмотреть его состояние и время очереди перед отправкой задания.	Н/П
Отправка задания в Azure Quantum	В программе Q# выберите рабочую область, поставщик и целевой объект. Чтобы отправить текущую программу Q#, щелкните стрелку рядом с целевым объектом.	Дополнительные сведения см. в статье "Отправка заданий Q# в Azure Quantum".	Н/П
Просмотр результатов задания	Разверните рабочую область и разверните задачи. Чтобы открыть выходные данные задания из хранилища Azure, щелкните на значок облака рядом с именем задания.	Работы перечислены с самыми последними вверху списка.	Н/П