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

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

Совет

Большинство связанных команд Q# можно получить в меню "Палитра команд представления>". В файле 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".	Н/П
Вопрос. Подключение к рабочей области Azure Quantum	Подключитесь к рабочей области Azure Quantum с помощью учетной записи Azure или строка подключения. После проверки подлинности рабочая область появится в проводник в квантовых рабочих областях.	Дополнительные сведения о подключениях Azure Quantum см. в статье "Подключение к рабочей области Azure Quantum".	В проводник наведите указатель мыши на рабочие области Quantum и щелкните значок "+".
Q#: Открытие игровой площадки Q#	Открывает онлайн-папку примеров программ Q# в проводник. Вы можете редактировать и запускать программы в локальном квантовом симуляторе, а также задавать точки останова и выполнять шаги по коду со встроенным отладчиком.	Дополнительные сведения см . в файле README в образце папки.	Н/П
Вопрос. Обновление рабочих областей Azure Quantum	Синхронизирует последние изменения из подключенных квантовых рабочих областей.	Если возникла проблема с подключением, рядом с именем рабочей области появится значок оповещения.	В проводник наведите указатель мыши на рабочие области Quantum и щелкните значок обновления.
Обозреватель: фокус на представлении квантовых рабочих областей	Открывает проводник и фокусируется на подключенных квантовых рабочих областях при настройке. Если рабочие области не настроены, вам будет предложено добавить существующую рабочую область.	Дополнительные сведения о подключениях Azure Quantum см. в статье "Подключение к рабочей области Azure Quantum".	Н/П

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

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

• Проверка ошибок предварительной компиляции
• Определение "Перейти к"
• Ссылки
• Подписи функций
• Информация о параметре
• Предложения по завершению
• Linting — в файлах Q# вы настраиваете подстроку подстроек для каждого проекта в файле манифеста. Дополнительные сведения см. в статье "Работа с проектами 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, щелкните значок облака рядом с именем задания.	Задания перечислены с самыми последними на вершине.	Н/Д