Справка: расширение Microsoft Quantum Development Kit для Visual Studio Code

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

Совет

Большинство команд из расширения QDK доступны в меню «Вид» — «Палитра команд»>. .qs В файле откройте палитру команд и введите QDK: чтобы просмотреть отфильтрованный список команд.

Команды

Большинство команд QDK связаны с записью и запуском программ Q# и доступны только в том случае, если .qs файл активен. Другие команды работают в фоновом режиме и недоступны в палитре команд.

В следующей таблице описываются команды расширения QDK, которые отображаются в палитре команд.

Совет

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

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

При активном .qs файле доступны следующие команды.

Команда	Действие	Примечания.	Альтернативное действие пользователя
QDK: Показать схему	Отображает схему канала для программы Q# перед запуском.	Дополнительные сведения см. в разделе Визуализация схем квантовых каналов.	Выберите опцию Code Lens из меню рядом с операцией точки входа или над каждой пользовательской операцией в программе.
QDK: запуск файла и отображение гистограммы	Запускает текущую программу Q# и отображает гистограмму результатов в новой области.	Чтобы получить доступ к параметрам сортировки и фильтрации для отображения гистограммы, выберите значок фильтра в области гистограммы.	Выберите параметр линзы кода гистограмма в меню рядом с операцией точки входа.
QDK: Получение QIR для текущей программы QDK	Открывает источник QIR для текущего кода Q# в новом окне редактирования. Программа должна использовать профиль целевого объекта Base, Adaptive RI или Adaptive RIF для экспорта источника QIR.	Дополнительные сведения о QIR см. в промежуточном представлении Quantum и блоге разработчика Q#.	Н/П
QDK: вычисление оценки ресурсов	Вызывает встроенную версию оценщика ресурсов.	Дополнительные сведения см. в разделе "Общие сведения об оценке ресурсов Microsoft Quantum".	Н/П
QDK: Справка	Краткий обзор расширения QDK в VS Code.	Полные сведения о документации по Microsoft Quantum см. в документации по Microsoft Quantum.	Н/П
QDK: запустить файл и отобразить схему	Запускает текущую программу Q# и отображает канал программы с выходными данными.	Дополнительные сведения см. в разделе Визуализация схем квантовых каналов.	Н/П
QDK: Добавление файла инструкций Copilot для Q# и OpenQASM	Открывает окно с предложением добавить инструкции Copilot для написания и выполнения кода Q# и OpenQASM.	Дополнительные сведения см. в разделе "Настройка режима агента" в VS Code для microsoft Quantum Development Kit.	Н/П
QDK: отображение документации по API	Открывает документацию по API в новой панели. Чтобы выполнить поиск в этой области, нажмите клавиши CTRL+F.	Дополнительные сведения см. в справочнике API Azure Quantum.	Н/П
QDK: Показать журнал изменений	Открывает журнал изменений на новой вкладке, где отображаются обновления QDK для текущих и всех предыдущих версий выпуска.	Журнал изменений также доступен в репозитории QDK GitHub с открытым исходным кодом.	Н/П
Отладка: запуск отладки	Открывает текущую программу Q# в отладчике.	Дополнительные сведения см. в статье отладка и тестирование квантового кода.	Нажмите клавишу F5 или выберите параметр "Отладка " в меню рядом с операцией точки входа или щелкните значок "Выполнить " в правом верхнем углу и нажмите кнопку "Начать отладку".
Отладка: запуск	Запускает текущую программу Q# в квантовом симуляторе по умолчанию.	Дополнительные сведения см. в статье "Начало работы с программами Q#".	Нажмите Ctrl+F5, или выберите в меню рядом с точкой входа операцией параметр Линза кода, или щелкните значок Выполнить в правом верхнем углу и выберите Выполнить.

Терминалы

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

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

Изменение кода Q#

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

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

Дополнительные сведения см. в разделе Intellisense документации по VS Code.

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

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

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

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

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

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

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