커맨드 팔레트 69부: 명령 이름과 명령 ID를 구분해 검색하기

VS CODE 초보자 시리즈 · 커맨드 팔레트 69부

커맨드 팔레트 69부: 명령 이름과 명령 ID를 구분해 검색하기

읽기 쉬운 명령 이름과 정확한 식별자를 구분해 찾고, 검색 원문으로 돌아옵니다.

이번 편의 핵심

이름 검색은 후보를 찾는 출발점입니다. 명령 ID를 대조하고 정확한 ID 검색 결과와 구분하면, 비슷한 이름을 같은 명령으로 오해하지 않을 수 있습니다.

68부에서는 검색어와 필터를 분리했습니다. 이번에는 검색하려던 대상이 화면의 이름인지 명령 ID인지부터 구분합니다.

목차

1. 시작하기 전에
2. 알아둘 핵심 개념
3. 순서대로 진행하기
4. 완료 확인하기
5. 문제가 생겼다면
6. 핵심 정리와 공식 자료

1. 시작하기 전에

난이도는 초급입니다. 68부에서 익힌 검색 원문 보존과 복원을 이어갑니다. 오늘 목표는 같은 명령을 이름과 ID로 구분해서 찾고, 원래 검색으로 돌아오는 것입니다.

준비할 것

• 이미 열린 바로 가기 키(Keyboard Shortcuts) 화면을 준비합니다. 파일 검색이나 명령 팔레트 입력창은 대상이 아닙니다.
• 도움말(Help) → 정보(About)에서 설치 버전을 확인합니다. 이 글은 Stable 1.140.0의 공식 문서와 소스를 기준으로 합니다.
• 키 기록(Record Keys)이 꺼져 있고 단축키 변경 창이 없는지 확인합니다. 상태가 불분명하면 입력하지 않습니다.
• 검색 원문을 보존할 개인 메모를 준비합니다. 클립보드에만 남기면 뒤의 ID 복사에서 덮어쓸 수 있습니다.

적용 환경 Windows 11 데스크톱, 한국어 또는 영어 UI, PowerShell 기본 맥락입니다. 셸 명령·관리자 권한·특정 작업 폴더는 필요 없습니다. 비교하는 동안 프로필·확장·UI 언어·키보드 배열을 유지합니다.

안전하게 시작하기 보호 대상은 원래 검색, 단축키 정의, 설정과 프로젝트 파일입니다. 검색 문자열·검색 기록과 클립보드는 바뀔 수 있습니다. 검색 원문을 별도 메모에 보존하고 본인이 입력 위치를 확인한 뒤 진행하세요. 행의 더블 클릭·Enter·연필·추가·삭제·재설정은 사용하지 않습니다. 중단 조건: 원문을 잃었거나 검색창·키 기록 상태를 구분할 수 없거나 변경 창이 나타나면 멈춥니다.

기본 Ctrl+F는 검색창으로 초점을 옮기며 기존 입력을 선택할 수 있습니다. 선택 상태를 보지 않고 바로 입력하지 마세요. 검색창의 Esc는 검색을 지울 수 있으므로 일반적인 취소 키로 사용하지 않습니다.

공식 자료 1 · 공식 자료 5

2. 알아둘 핵심 개념

이름은 읽는 표지, ID는 명령 식별자입니다

명령 이름은 화면에 표시되는 사람이 읽기 쉬운 제목입니다. UI 언어에 따라 달라질 수 있습니다. 명령 ID는 명령을 식별하는 문자열입니다. 예를 들어 공식 단축키 표의 Toggle Line Comment는 editor.action.commentLine과 연결됩니다. 이 글에서는 주석 명령을 실행하지 않고 검색 예시로만 사용합니다.

일반 검색은 이름만 검색하는 기능이 아닙니다

일반 텍스트 검색은 명령 이름뿐 아니라 ID 등에도 맞을 수 있습니다. 따라서 이름으로 결과가 나왔다는 사실만으로 원하는 명령을 확정하지 않습니다. 결과 행에서 ID를 함께 확인합니다. 이름을 큰따옴표로 감싸지 마세요. 양쪽 큰따옴표 검색은 키 조합 검색에 다른 의미를 가집니다.

정확한 ID를 찾을 때는 @command:

@command:editor.action.commentLine

위 한 줄은 바로 가기 키 검색창에 넣는 검색식입니다. 터미널 명령이나 JSON 설정이 아닙니다. 그대로 사용할 수 있는 고정 예시이며 치환할 부분은 없습니다. 기준 버전의 @command:는 ID 전체를 대소문자까지 정확히 비교합니다. 이번에는 이 검색식만 단독으로 사용하고, 뒤에 이름이나 소스 필터를 덧붙이지 않습니다.

ID 하나와 결과 행 하나는 같은 뜻이 아닙니다. 같은 명령에 여러 키바인딩이 있으면 여러 행이 나타날 수 있습니다. 결과가 있다는 것만으로 해당 키가 현재 화면에서 실행 가능한지도 확정하지 않습니다.

공식 자료 2 · 공식 자료 3 · 공식 자료 4

3. 순서대로 진행하기

다음 정상 결과는 공식 자료에 따른 예상입니다. 실제 화면이 다르면 실패 분기를 따릅니다. 이번에는 명령을 호출하거나 새 키를 지정하지 않습니다.

1. 화면과 원문 보존

목적 비교 뒤 돌아올 출발점을 남깁니다.

1. 키 기록이 꺼진 바로 가기 키 화면에서 현재 검색창의 전체 원문을 개인 메모에 적습니다.

입력 위치 검색창은 읽기만 하고 메모는 본인만 볼 수 있는 곳에 둡니다.

Q = 현재 검색 원문
현재 UI 언어 · 프로필

정상 결과 빈 검색이면 ‘빈 문자열’로 구분하고, 내용이 있으면 공백·따옴표·기호까지 보존합니다. Q라는 글자를 입력하는 것이 아닙니다.

확인 메모와 화면 원문을 글자 단위로 대조합니다. 기록 꺼짐과 변경 창 없음도 확인합니다.

실패 신호 원문 일부가 보이지 않거나 기록 상태를 구분하지 못합니다.

복구·재합류 검색을 바꾸지 말고 중단합니다. 전체 원문과 화면 상태를 확인할 수 있을 때 1단계부터 다시 시작합니다.

2. 이름으로 후보 찾기

목적 사람이 읽는 이름으로 후보 목록을 봅니다.

1. 검색창에 초점을 주고 전체 선택이 확인된 상태에서 아래 이름을 따옴표 없이 입력합니다.

입력 위치 바로 가기 키 검색창. 한국어 UI에서는 화면에 쓰이는 해당 명령 이름을 사용할 수 있습니다.

Toggle Line Comment

정상 결과 일반 텍스트에 맞는 목록이 갱신됩니다. 영문 이름 검색의 결과는 언어·환경에 따라 다를 수 있습니다.

확인 검색창 문자열과 결과 행의 명령 이름을 각각 확인합니다. 결과가 없어도 고장으로 결론 내리지 않습니다.

실패 신호 원문 일부가 남거나 키 기록이 시작되거나 다른 입력창에 글자가 들어갑니다.

복구·재합류 입력을 멈춥니다. 안전한 검색창을 확인할 수 있을 때만 Q로 복원합니다. 이름 결과가 없으면 이름 결과를 ‘없음’으로 적고 4단계의 고정 ID 예시로 비교할 수 있습니다.

3. 후보의 ID 확인하기

목적 비슷한 표시 이름 사이에서 명령을 구분합니다.

1. 후보 행의 오른쪽 클릭 메뉴에서 ID를 복사하는 항목을 선택합니다. 영어 UI의 기준 표기는 Copy Command ID이며, 한국어 메뉴 표현은 언어 팩에 따라 다를 수 있습니다.

입력 위치 2단계에서 찾은 후보 행의 메뉴. 항목이 분명히 보일 때만 선택합니다.

복사된 ID를 개인 메모에 기록

정상 결과 클립보드에 그 행의 명령 ID가 들어갑니다. 이 복사 동작은 대상 명령을 실행하거나 키바인딩을 편집하지 않습니다.

확인 개인 메모의 별도 칸에서 ID를 읽고 editor.action.commentLine과 대조합니다. 원문 Q가 별도로 보존돼 있는지도 확인합니다.

실패 신호 ID 복사 항목을 찾지 못하거나 다른 편집 메뉴를 선택했거나 ID가 예시와 다릅니다.

복구·재합류 메뉴를 추측해 누르지 않습니다. 아무 항목도 선택하지 않았거나 ID만 복사한 경우에는 검색창으로 안전하게 돌아가 4단계의 공식 ID 예시를 사용할 수 있습니다. 편집 항목을 선택했다면 변경 창이 없어도 중단하고 키바인딩 변경 여부부터 확인합니다. 안전한 복구를 확인하기 전에는 재합류하지 않습니다. ID가 다르면 같은 명령이라고 기록하지 않습니다.

4. ID만 정확히 검색하기

목적 확인된 식별자를 기준으로 목록을 좁힙니다.

1. 검색창 전체를 아래 한 줄로 바꿉니다.

입력 위치 바로 가기 키 검색창. 키 기록 꺼짐·전체 선택·Q 보존을 다시 확인합니다.

@command:editor.action.commentLine

정상 결과 기준 구현에서는 이 ID와 정확히 같은 명령의 행을 찾습니다. 여러 행 또는 빈 결과가 나올 수 있습니다.

확인 검색식 뒤에 이름·필터·따옴표가 붙지 않았는지 봅니다. 행이 있으면 키·When·소스 열을 읽습니다. @command 결과에서는 ID가 이름 아래에 보이지 않을 수 있습니다. ID를 다시 대조해야 하면 행의 도움말을 보거나, 3단계의 Copy Command ID로 별도 메모에서 확인합니다. ID가 화면에 생략된 것만으로 실패라고 판단하지 않습니다.

실패 신호 철자·대소문자가 다르거나 위 고정 예시와 다른 문자열, 예상 밖의 화면이 보입니다.

복구·재합류 검색창과 기록 꺼짐이 확실할 때만 고정 예시와 한 번 대조합니다. 그래도 비면 ‘정확한 ID 검색에서 결과 없음’으로 남기고 복원 단계로 갑니다. 재설치나 단축키 추가로 결과를 만들지 않습니다.

5. 검색 원문으로 돌아오기

목적 진단 때문에 바뀐 검색 조건을 되돌립니다.

1. 검색창 전체를 처음 메모한 Q로 복원합니다. 원래 비어 있었다면 빈 검색으로 되돌립니다.

입력 위치 바로 가기 키 검색창. 원문은 클립보드가 아닌 별도 메모에서 확인합니다.

최종 검색 = 보존한 Q

정상 결과 최종 검색 문자열이 처음과 일치합니다. 환경이 같다면 원래 목록과도 비교할 수 있습니다.

확인 메모·검색창·현재 목록을 대조하고, 키 기록이 꺼져 있으며 단축키·설정을 편집하지 않았는지 확인합니다.

실패 신호 Q가 사라졌거나 같은 Q에서 환경·목록이 달라졌거나 편집이 일어났습니다.

복구·재합류 문자열을 추측하지 않고 상태와 직전 행동을 남깁니다. 안전한 복원을 확인하기 전에는 완료로 표시하지 않습니다. 확인되면 1단계부터 다시 비교합니다.

공식 자료 1 · 공식 자료 3 · 공식 자료 4 · 공식 자료 5

4. 완료 확인하기

입력한 검색창만 보지 말고, 별도 메모와 공식 명령 표를 함께 대조합니다.

• 이름 검색의 결과 있음/없음과 정확한 ID 검색의 결과를 서로 다른 칸에 기록했나요?
• 후보 ID를 확인했다면 공식 표의 editor.action.commentLine과 일치하나요? 다른 ID라면 다른 후보로 남겼나요?
• 현재 검색창은 별도 보존한 Q와 정확히 같고, 원래 빈 검색이었다면 비어 있나요?
• 키 기록은 꺼져 있고 명령 실행·키바인딩·설정·프로젝트 파일 편집은 없었나요?

완료 기준 이름은 읽는 제목, ID는 식별자임을 설명하고 두 검색의 관찰 결과를 구분한 뒤 원문으로 돌아왔습니다. 결과를 반드시 한 행으로 만드는 것이 목표는 아닙니다.

이름 검색은 없고 ID 검색은 있다면, 두 검색 조건에서 관찰된 차이까지만 말합니다. 번역·명칭 차이의 가능성은 있지만 원인 확정은 아닙니다. 둘 다 비어 있어도 삭제·손상으로 단정하지 않습니다.

공식 자료 2 · 공식 자료 3

5. 문제가 생겼다면

복사했더니 원문을 잃었습니다

먼저 확인 Q를 별도 메모에 남겼는지 봅니다. ID 복사는 클립보드 내용을 바꿉니다.

복구 메모가 없다면 원문을 추측하지 않습니다. 현재 문자열과 직전 행동을 보존하고 중단합니다.

재합류 원문과 검색 화면을 확인할 수 있을 때 1단계

@command: 뒤에 이름이나 필터를 붙였습니다

먼저 확인 ID 뒤의 공백과 나머지 문자를 봅니다. 이 검색을 일반 텍스트와 자유롭게 결합할 수 있다고 가정하지 마세요.

복구 Q가 안전하고 입력 위치가 명확할 때만 4단계의 단독 검색식으로 바꿉니다. 키나 설정은 수정하지 않습니다.

재합류 4단계 확인 후 5단계 복원

기록 모드나 변경 창이 나타났습니다

먼저 확인 화면 이름, 기록 버튼 상태, 오류 원문과 직전 행동을 적습니다. 비공개 정보는 외부에 공유하지 않습니다.

복구 새 키·Enter·저장·승인 버튼을 누르지 않습니다. 기록 버튼의 켜짐이 명확할 때만 보이는 버튼으로 끕니다. 변경 창이나 상태가 불분명하면 중단합니다. Alt+K를 해제 키로 추측하지 않습니다.

재합류 실제 변경이 없고 원문이 보존된 것을 확인한 뒤 1단계

핵심 판단 확인하지 못한 원인은 미확인(UNKNOWN)으로 남깁니다. 복구 뒤에도 원문, 기록 모드와 보호 대상 상태를 다시 대조합니다.

공식 자료 3 · 공식 자료 4 · 공식 자료 5

6. 핵심 정리와 공식 자료

• 명령 이름과 ID를 구분하고 일반 검색의 후보를 ID로 대조합니다.
• @command:에는 정확한 ID 하나만 넣어 비교합니다.
• 검색 결과보다 원문 복원과 변경하지 않은 상태까지 확인합니다.

공식 자료

기준 시점은 2026년 10월 7일 19:00 KST입니다. 같은 날 공식 문서와 1.140.0 소스를 확인했습니다. 릴리스 페이지는 2026년 9월 30일 공개를 표시합니다. 개별 문서의 별도 발행일이 없는 경우 고정 버전과 확인일을 기준으로 삼았습니다.

이 글의 정상 결과·오류 대응은 공식 자료에 따른 예상입니다. Windows에서 실제 수행한 관찰 결과를 제시하지 않습니다. 설치 버전과 UI가 다르면 화면·메뉴를 추측해 조작하지 마세요.

• 1. 바로 가기 키 편집기와 검색 · Microsoft
• 2. 기본 명령 이름·ID 표 · Microsoft
• 3. 검색식과 명령 ID 일치 처리 · 1.140.0 · Microsoft
• 4. 명령 ID 복사와 편집기 동작 · 1.140.0 · Microsoft
• 5. 검색 초점·기록 명령 · 1.140.0 · Microsoft
• 6. Stable 1.140 릴리스 · Microsoft

이전 편: 커맨드 팔레트 68부 · 검색어와 필터를 나누어 점검하기

다음 편 예고 커맨드 팔레트 70부에서는 같은 명령 ID가 여러 행으로 보일 때 키·When·소스를 나누어 읽습니다. 이번 편의 정확한 ID 검색과 원문 복원이 선수 조건이며, 키바인딩은 편집하지 않습니다.