참조: Visual Studio Code용 Azure Quantum Development Kit 확장
Azure QDK(Quantum Development Kit)는 .qs 파일을 사용할 때 Q#관련 기능과 함께 VS(Visual Studio) 코드의 모든 표준 기능을 사용합니다. 이 문서는 필요에 따라 추가 콘텐츠에 대한 링크가 있는 모든 Q# 관련 명령 및 기능에 대한 참조 가이드입니다. 일반적인 VS Code 지침은 VS Code 설명서를 참조 하세요.
팁
대부분의 Q# 관련 명령은 명령 팔레트 보기 > 메뉴에서 액세스할 수 있습니다. .qs 파일에 있는 동안 Ctrl-Shift-P(macOS의 Cmd-Shift-P)를 선택하고 Q#을 입력하여 필터링된 명령 목록을 봅니다.
모든 macOS 바로 가기 키는 macOS의 바로 가기 키를 참조하세요.
명령
대부분의 Q# 관련 명령은 명령 팔레트 보기 > 메뉴에서 액세스할 수 있습니다. Ctrl-Shift-P를 선택하고 Q#을 입력하여 필터링된 명령 목록을 봅니다. 일부 명령은 .qs 파일이 활성화된 경우에만 사용할 수 있습니다.
팁
바로 가기 키 또는 Ctrl+K+S를 사용하여 VS Code 명령에 대한 사용자 지정 바로 가기 키를 만들 수 있습니다. 자세한 내용은 VS Code에 대한 키 바인딩을 참조 하세요.
| 명령 | 작업 | 주의 | 대체 사용자 작업 |
|---|---|---|---|
| Q#: Q# 프로젝트 만들기 | 다음을 포함하여 현재 폴더에 Q# 프로젝트를 만듭니다. * qsharp.json 매니페스트 파일 * 기본 main.qs 파일이 있는 src 하위 폴더입니다. |
Q# 프로젝트에 대한 자세한 내용은 Q# 프로젝트 작업을 참조 하세요. | 파일 탐색기 대상 폴더를 마우스 오른쪽 단추로 클릭하고 Q# 프로젝트 만들기를 선택합니다. |
| Q#: Azure Quantum Notebook 만들기 | Q# + Python 프로그램을 실행하고 Azure Quantum에 작업을 제출하는 샘플 Jupyter Notebook을 엽니다. | Azure Quantum Notebook에 대한 자세한 내용은 Azure Quantum Notebook 작업을 참조 하세요. | 해당 없음 |
| Q#: Azure Quantum 작업 영역에 연결 | Azure 계정 또는 연결 문자열 사용하여 Azure Quantum 작업 영역에 연결합니다. 인증되면 작업 영역이 Quantum 작업 영역의 파일 탐색기 표시됩니다. | Azure Quantum 연결에 대한 자세한 내용은 Azure Quantum 작업 영역에 연결을 참조하세요. | 파일 탐색기 Quantum 작업 영역을 마우스로 가리키고 "+" 아이콘을 선택합니다. |
| Q#: Q# 플레이그라운드 열기 | 파일 탐색기 Q# 샘플 프로그램의 온라인 폴더를 엽니다. 로컬 양자 시뮬레이터에서 프로그램을 편집하고 실행하고, 기본 제공 디버거를 사용하여 중단점을 설정하고 코드를 단계별로 실행할 수도 있습니다. | 자세한 내용은 샘플 폴더의 추가 정보 파일을 참조하세요. | 해당 없음 |
| Q#: Azure Quantum 작업 영역 새로 고침 | 연결된 양자 작업 영역의 최신 변경 내용을 동기화합니다. | 연결 문제가 있는 경우 작업 영역 이름 옆에 경고 아이콘이 나타납니다. | 파일 탐색기 Quantum 작업 영역을 마우스로 가리키고 새로 고침 아이콘을 선택합니다. |
| 탐색기: 양자 작업 영역 보기에 집중 | 파일 탐색기 열고 구성된 경우 연결된 양자 작업 영역에 중점을 둡니다. 구성된 작업 영역이 없는 경우 기존 작업 영역을 추가하라는 메시지가 표시됩니다. | Azure Quantum 연결에 대한 자세한 내용은 Azure Quantum 작업 영역에 연결을 참조하세요. | 해당 없음 |
.qs 파일이 활성화된 경우 다음 명령을 사용할 수 있습니다.
| 명령 | 작업 | 주의 | 대체 사용자 작업 |
|---|---|---|---|
| Q#: Azure Quantum QIR 대상 프로필 설정 | Q# 프로그램의 QIR 또는 양자 중간 표현 대상 프로필을 설정합니다. | 대상 프로필에 대한 자세한 내용은 대상 프로필을 참조 하세요. | 현재 대상 프로필이 아래쪽 도구 모음에 표시됩니다. 도구 모음에서 대상 프로필을 선택하여 선택 드롭다운을 엽니다. |
| Q#: 회로 표시 | 실행하기 전에 Q# 프로그램의 회로 다이어그램을 표시합니다. | 자세한 내용은 양자 회로 다이어그램 시각화를 참조 하세요. | 진입점 작업 옆의 메뉴에서 또는 프로그램의 각 사용자 정의 작업 위에 있는 코드 렌즈 옵션 회로 를 선택합니다. |
| Q#: 파일 실행 및 히스토그램 표시 | 현재 Q# 프로그램을 실행하고 오른쪽 창에 결과의 히스토그램을 표시합니다. | 히스토그램 표시에 대한 정렬 및 필터 옵션에 액세스하려면 히스토그램 창에서 필터 아이콘을 선택합니다. | 진입점 작업 옆의 메뉴에서 코드 렌즈 옵션 히스토그램 을 선택합니다. |
| Q#: 현재 Q# 프로그램에 대한 QIR 가져오기 | 새 편집 창에서 현재 Q# 코드에 대한 QIR 소스를 엽니다. 프로그램에서 기본 또는 적응 RI 대상 프로필을 사용하여 QIR 원본을 내보내야 합니다. | QIR에 대한 자세한 내용은 Quantum 중간 표현 및 Q# 개발자 블로그를 참조하세요. | 해당 없음 |
| 디버그: Q# 파일 디버그 | 디버거에서 현재 Q# 프로그램을 엽니다. | 자세한 내용은 양자 코드 디버깅 및 테스트를 참조하세요. | * F5 선택 * 진입점 작업 옆의 메뉴에서 코드 렌즈 옵션 디버그 를 선택합니다. * 오른쪽 위에서 실행 아이콘을 선택하고 Q# 파일 디버그를 선택합니다. |
| 디버그: Q# 파일 실행 | 기본 양자 시뮬레이터에서 현재 Q# 프로그램을 실행합니다. | 자세한 내용은 Q# 프로그램 시작을 참조 하세요. | * Ctrl+F5 선택 * 진입점 작업 옆에 있는 메뉴에서 코드 렌즈 옵션 실행을 선택합니다. * 오른쪽 위에 있는 실행 아이콘을 선택하고 Q# 파일 실행을 선택합니다. |
| Q#: 자원 예측 계산 | 기본 제공 버전의 리소스 추정기를 호출합니다. | 자세한 내용은 Azure Quantum 리소스 추정기 소개를 참조 하세요. | 해당 없음 |
| Q#: 도움말 | VS Code의 QDK 확장에 대한 간략한 개요입니다. | 전체 Azure Quantum 설명서는 Azure Quantum 설명서를 참조 하세요. | 해당 없음 |
| Q#: 파일 실행 및 회로 다이어그램 표시 | 현재 Q# 프로그램을 실행하고 출력이 있는 프로그램의 회로를 표시합니다. | 자세한 내용은 양자 회로 다이어그램 시각화를 참조 하세요. | 해당 없음 |
| Q#: API 설명서 표시 | 새 창에서 API 설명서를 엽니다. Ctrl-F를 사용하여 이 창을 검색합니다. | 자세한 내용은 Azure Quantum API 참조를 참조하세요. | 해당 없음 |
터미널
Q# 프로그램은 VS Code에서 두 개의 터미널 창을 사용합니다.
| Terminal | 작업 |
|---|---|
| 디버그 콘솔 | 실행 출력 또는 디버그 출력을 표시합니다. |
| 문제 | 미리 컴파일된 오류 검사를 표시합니다. |
Q# 코드 편집
VS Code의 일반적인 코드 편집 기능 대부분은 Q# 프로그램을 사용할 때 사용할 수 있습니다. 자세한 내용은 VS Code 설명서의 Intellisense를 참조하세요.
- 사전 컴파일 오류 검사
- 이동 정의
- 참조
- 함수 서명
- 매개 변수 정보
- 완료 제안
- Linting - Q# 파일에서 매니페스트 파일에서 프로젝트당 linting을 구성합니다. 자세한 내용은 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 프로그램에 붙여넣습니다. | 자세한 내용은 Azure Quantum에 Q# 작업을 사용하여 Python 제출을 참조 하세요. | 해당 없음 |
프로그램 실행
| 작업 | 작업 | 주의 | 대체 사용자 작업 |
|---|---|---|---|
| 로컬 양자 시뮬레이터에서 Q# 프로그램 실행 | Q# 프로그램에서 오른쪽 위에 있는 실행 아이콘을 선택하고 Q# 파일 실행을 선택합니다. | 양자 시뮬레이터에 대한 자세한 내용은 스파스 양자 시뮬레이터를 참조 하세요. | * Ctrl-F5 선택 * 명령 팔레트에서 Q#을 선택합니다 . 파일 실행 및 히스토그램 또는 Q#표시: 파일 실행 및 회로 다이어그램 표시 * 진입점 작업 옆에 있는 메뉴에서 코드 렌즈 옵션 실행을 선택합니다. |
| 프로그램 디버그 | Q# 프로그램에서 오른쪽 위에 있는 실행 아이콘을 선택하고 Q# 파일 디버그를 선택합니다. | VS Code의 Q# 디버거에 대한 자세한 내용은 양자 코드 디버깅 및 테스트를 참조하세요. | * F5 선택 * 진입점 작업 옆의 메뉴에서 코드 렌즈 옵션 디버그 를 선택합니다. |
| 작업 영역에서 공급자 및 대상 보기 | 파일 탐색기 Quantum 작업 영역을 선택하고 작업 영역을 확장한 다음 공급자를 확장하여 작업 영역에서 사용 가능한 공급자를 확인합니다. 개별 공급자를 확장하여 사용 가능한 대상을 봅니다. | 참고: 작업을 제출하기 전에 대상 이름을 마우스로 가리키면 상태 및 큐 시간을 볼 수 있습니다. | 해당 없음 |
| Azure Quantum에 작업 제출 | Q# 프로그램에서 작업 영역, 공급자 및 대상을 선택합니다. 현재 Q# 프로그램을 제출하려면 대상 옆에 있는 화살표를 선택합니다. | 자세한 내용은 Azure Quantum에 Q# 작업 제출을 참조 하세요. | 해당 없음 |
| 작업 결과 보기 | 작업 영역을 확장한 다음 작업을 확장 합니다. Azure Storage에서 작업 출력을 열려면 작업 이름 옆에 있는 클라우드 아이콘을 선택합니다. | 작업은 맨 위에 가장 최근 항목이 나열됩니다. | 해당 없음 |