커맨드 팔레트 67부: 검색어가 남아 있는 화면에서 현재 필터 확인하기
바로 가기 키 화면에 남아 있는 검색어를 바꾸지 않고, 현재 목록에 적용된 검색 조건을 읽습니다.
이번 편의 핵심
검색창의 원문과 결과 행의 소스를 함께 보면 지금 어떤 범위의 목록인지 설명할 수 있습니다. 기존 검색어를 그대로 유지한 채 조건을 읽고, 결과가 없다면 그 사실까지만 확인합니다.
66부에서는 검색창과 목록의 초점을 나눠 보았습니다. 이번에는 같은 화면에 남아 있는 검색어가 결과 범위를 어떻게 좁히는지 살펴봅니다. 화면이 열렸다는 사실만으로 전체 바로 가기 키가 보인다고 생각하지 마세요.
1. 시작하기 전에
난이도는 초급입니다. 검색창과 결과 목록을 구분할 수 있으면 따라갈 수 있습니다. 이번 목표는 기존 검색 조건의 확인이며, 검색어·단축키·설정의 변경은 포함하지 않습니다.
준비할 것
- 66부의 검색창과 목록 초점 구분을 알고 있어야 합니다. 현재 입력 위치를 말할 수 있는지 먼저 확인하세요.
- 이미 열린 바로 가기 키(Keyboard Shortcuts) 화면을 준비합니다. 제목과 검색창, 명령 목록의 열이 보이는지 확인합니다. keybindings.json 편집창은 대상이 아닙니다.
- 도움말(Help) → 정보(About)에서 설치 제품과 버전을 확인합니다. 이 글은 2026년 9월 30일 공개된 Stable 1.140.0을 기준으로 합니다.
- 검색어가 남아 있으면 그대로 둡니다. 비어 있다면 이번 편에서는 ‘검색어 없음’을 기록하고, 예시를 따라 입력해 상태를 만들지는 않습니다.
- 키 기록 모드와 단축키 변경 창이 꺼져 있는지 확인합니다. 현재 모드를 구분할 수 없다면 입력하지 않고 중단합니다.
적용 환경 Windows 11 데스크톱 · VS Code Stable 1.140.0 · 한국어 또는 영어 UI · PowerShell 기본 맥락입니다. 셸 명령을 실행하지 않으므로 터미널·작업 디렉터리·관리자 권한은 필요하지 않습니다. 활성 프로필, 사용자 키바인딩, 키맵 확장, 키보드 배열에 따라 기본 키와 결과가 달라질 수 있습니다. 모달 창 또는 탭 중 실제 화면 형태를 유지하고 설정을 바꾸지 않습니다.
Esc 주의 검색창에 초점이 있고 검색어가 남아 있는 일반 상태에서는 Esc가 검색어를 지울 수 있습니다. 빠져나오기 위해 무작정 Esc를 누르지 마세요. Ctrl+F는 검색창에 초점을 주면서 기존 내용을 선택하므로, 이어서 문자를 입력하면 기존 검색어를 덮어쓸 수 있습니다.
2. 알아둘 핵심 개념
검색어가 현재 목록의 범위를 정합니다
바로 가기 키 편집기는 명령 이름이나 키 조합으로 목록을 찾는 화면입니다. 검색창에는 일반 텍스트뿐 아니라 @source:user 같은 필터 표현이 들어갈 수 있습니다. 필터는 현재 목록을 좁히는 검색 조건이며, 이 표현 자체가 단축키를 새로 지정하지는 않습니다.
소스 필터를 먼저 읽습니다
@source:user는 사용자 정의 항목, @source:system 또는 @source:default는 시스템 항목, @source:extension은 확장 제공 항목으로 범위를 좁힙니다. 결과 행의 소스(Source) 열을 함께 보세요. 일반 텍스트가 뒤에 남아 있으면 그 텍스트 조건도 확인합니다. 임의의 필터 여러 개를 붙이면 모두 AND 조건으로 결합된다고 가정하지 않습니다.
따옴표와 특수 표현은 원문 그대로 봅니다
copy는 일반 검색어의 예시입니다. "ctrl+k"처럼 따옴표로 감싼 키 조합 검색은 키 바인딩을 기준으로 찾습니다. 이 예시는 Ctrl+K로 시작하는 긴 조합도 포함할 수 있으므로 ‘전체 조합이 딱 이것인 항목만’이라고 단정하지 않습니다.
@command:는 명령 ID, @ext:는 확장, @keybinding:은 키 바인딩을 지정하는 별도 검색 표현입니다. 이번 편에서는 이미 있는 표현을 식별하는 데까지만 사용합니다. 모르는 표현은 지우거나 조합하지 말고 ‘해석 보류’로 남깁니다. 위 예시는 읽기용이며 입력 지시나 치환용 플레이스홀더가 아닙니다.
기록 모드와 정렬은 따로 봅니다
키 기록(Record Keys)은 키 조합을 검색창에 기록하는 입력 모드입니다. 우선 순위에 따라 정렬(높은 것부터)은 결과의 순서를 바꾸는 기능입니다. 정렬이 켜져 있다고 별도의 소스 필터가 추가된 것은 아닙니다. 이번에는 두 버튼을 눌러 상태를 바꾸지 않습니다.
3. 순서대로 진행하기
아래 정상 결과는 공식 문서와 소스에 따른 예상입니다. 실제 Windows 수행을 관찰한 기록이 아니며, 각 단계에서 자신의 화면을 확인해야 합니다. 명령·코드·설정 파일을 입력하거나 실행하는 단계는 없습니다.
1. 대상 화면 확인
목적 엉뚱한 입력창에서 시작하지 않습니다.
- 현재 화면의 제목을 읽습니다.
입력 위치 바로 가기 키 화면의 제목과 열 머리글
바로 가기 키 / Keyboard Shortcuts관찰 대상 이 단계의 화면 상태입니다. 새 파일을 만들지 않습니다.
정상 결과 제목과 명령·키 바인딩·언제·소스 등의 목록 열이 보입니다.
확인 일반 파일·터미널·JSON 화면과 구분합니다.
실패 신호 제목이 다르거나 단축키 변경 대화상자가 열려 있습니다.
2. 남아 있는 검색 원문 읽기
목적 변경 전 검색 조건을 보존합니다.
- 검색창에 보이는 내용을 처음부터 끝까지 읽습니다.
입력 위치 바로 가기 키 화면 위쪽 검색창
관찰 대상: 공백·따옴표·@ 표현을 포함한 현재 검색 원문관찰 대상 이 단계의 화면 상태입니다. 새 파일을 만들지 않습니다.
정상 결과 기존 문자열 또는 빈 검색창 상태를 확인할 수 있습니다.
확인 회색 안내문과 실제 검색어를 구분합니다. 끝이 잘리면 확인된 검색창에만 초점을 두고 내용을 살펴봅니다.
실패 신호 문자열 일부가 안 보이거나 검색창을 특정할 수 없습니다.
3. 소스 제한 확인
목적 누구의 바로 가기 키를 보고 있는지 구분합니다.
- 현재 원문에 @source: 표현이 있는지 확인합니다.
입력 위치 같은 검색창의 원문
읽기 예시: @source:user관찰 대상 이 단계의 화면 상태입니다. 새 파일을 만들지 않습니다.
정상 결과 있으면 user·system·default·extension 중 실제 값을 읽고, 없으면 소스 필터 표현 없음으로 구분합니다.
확인 설명표와 실제 문자열을 대조합니다. 모르는 값은 의미를 확정하지 않습니다.
실패 신호 오탈자처럼 보이거나 알 수 없는 값이 있습니다.
4. 나머지 검색 조건 확인
목적 소스 제한 외에 남은 조건을 빠뜨리지 않습니다.
- 검색 원문에 남아 있는 일반 텍스트나 따옴표·특수 표현을 식별합니다.
입력 위치 같은 검색창의 원문
읽기 예시: @source:user copy관찰 대상 이 단계의 화면 상태입니다. 새 파일을 만들지 않습니다.
정상 결과 예시라면 사용자 정의 항목 가운데 copy 검색 조건을 적용한 상태로 설명합니다. 실제 화면은 자신의 원문에 맞춰 읽습니다.
확인 따옴표 유무와 실제 입력 문자를 대조합니다. @command 등의 별도 표현이 있으면 일반 텍스트로 뭉뚱그리지 않습니다.
실패 신호 현재 표현을 예시와 동일하게 해석할 근거가 없습니다.
5. 결과 행과 대조
목적 검색창 외의 화면 근거로 조건을 교차 확인합니다.
- 현재 보이는 결과 행의 소스 값을 읽습니다.
입력 위치 검색창 아래 결과 목록의 소스 열
관찰 대상: 소스 열의 사용자·시스템 또는 확장 표시관찰 대상 이 단계의 화면 상태입니다. 새 파일을 만들지 않습니다.
정상 결과 소스 필터가 있으면 그 조건에 대응하는 행을 확인할 수 있습니다. 결과가 없을 수도 있습니다.
확인 검색 원문에서 읽은 소스 조건과 행 표시를 비교합니다. 빈 목록은 현재 조건의 결과 없음으로만 기록합니다.
실패 신호 조건과 행이 맞지 않거나 열·결과를 구분할 수 없습니다.
6. 입력 모드와 정렬 구분
목적 검색 조건과 주변 버튼의 역할을 섞지 않습니다.
- 검색창 주변 버튼의 이름과 현재 표시 상태를 살펴봅니다.
입력 위치 키 기록 및 우선 순위 정렬 버튼
관찰 대상: 키 기록 / 우선 순위에 따라 정렬관찰 대상 이 단계의 화면 상태입니다. 새 파일을 만들지 않습니다.
정상 결과 기록 모드와 정렬 기능을 현재 검색 원문과 별도로 구분합니다.
확인 아이콘만으로 단정하지 말고 마우스를 올렸을 때의 이름 등 실제 안내를 확인합니다. 버튼은 누르지 않습니다.
실패 신호 키 기록이 켜져 있거나 버튼의 의미를 확인할 수 없습니다.
7. 변경 없이 마무리
목적 현재 조건을 스스로 설명할 수 있는지 확인합니다.
- 검색 조건과 결과의 관계를 한 문장으로 정리합니다.
입력 위치 현재 검색창과 결과 목록
정리 틀: 현재 검색 내용 / 소스 제한 / 보이는 결과 상태관찰 대상 이 단계의 화면 상태입니다. 새 파일을 만들지 않습니다.
정상 결과 무엇으로 좁혀진 목록인지, 결과가 있는지 없는지 설명할 수 있습니다.
확인 2단계에서 읽은 원문과 지금 원문이 같은지 대조합니다. 틀은 설명용이며 어느 입력창에도 붙여 넣지 않습니다.
실패 신호 검색어가 달라졌거나 변경 대화상자가 나타났습니다.
4. 완료 확인하기
검색창만 다시 보는 것으로 끝내지 말고 결과 목록의 소스 표시를 독립된 화면 근거로 대조합니다.
- 원문 보존: 시작할 때와 끝날 때의 검색어·따옴표·필터 표현이 같습니다. 검색창이 처음부터 비어 있었다면 그 사실을 그대로 설명합니다.
- 조건 설명: 일반 검색어와 소스 제한을 구분합니다. 알 수 없는 특수 표현을 억지로 해석하지 않습니다.
- 행 대조: 결과가 있을 때 소스 열과 현재 제한이 맞는지 확인합니다. 행을 실행하거나 단축키 변경 창을 열 필요는 없습니다.
- 빈 목록 분기: 결과가 없으면 소스 열 대조는 수행할 수 없습니다. ‘현재 조건에서 결과 없음’으로 기록하며 전체 단축키 삭제나 고장으로 판단하지 않습니다.
- 기능 구분: 기록 모드·정렬을 검색 원문의 필터와 구분합니다. 실제 결과 수 숫자가 항상 화면에 표시된다고 가정하지 않습니다.
완료 기준 기존 검색 원문을 유지하면서 현재 검색 조건과 소스 제한, 그 조건에서 보이는 결과 상태를 설명할 수 있습니다. 낯선 표현을 해석하지 못하거나 원문을 잃었다면 완료로 기록하지 않습니다.
5. 문제가 생겼다면
결과가 하나도 보이지 않을 때
먼저 확인 검색창이 비어 있는지, @source:와 일반 텍스트가 함께 남아 있는지, 화면 제목이 맞는지 확인합니다. 목록이 없다는 사실만으로 명령이나 단축키가 제거됐다고 말할 수는 없습니다.
복구 현재 조건을 보존하고 이번 편에서는 관찰까지만 마칩니다. 검색어 지우기·설정 초기화·확장 제거로 원인을 시험하지 않습니다.
재합류 2단계에서 원문을 다시 읽고, 5단계의 결과 없음 분기로 이어갑니다.
검색어를 실수로 바꾸거나 지웠을 때
먼저 확인 Ctrl+F 뒤 입력했는지, Esc나 검색 입력 지우기를 눌렀는지 직전 행동을 확인합니다.
복구 정확한 원문을 본인이 안전하게 보존했고, 키 기록이 꺼져 있고 대상이 바로 가기 키 검색창임을 확인한 경우에만 원문으로 되돌립니다. 이는 의도된 관찰 절차에서 벗어난 복구이며, 임의의 문자열을 추측해 채우지 않습니다. 원문을 모르면 중단하고 ‘원문 복구 불가’로 남깁니다. 파일·설정을 초기화하지 않습니다.
재합류 복구 후 문자열이 정확히 같은지 확인하고 2단계부터 다시 진행합니다.
키 기록이 켜져 있을 때
먼저 확인 ‘키를 기록하는 중입니다’ 같은 안내와 기록 버튼 상태를 확인합니다. 평소 이동 키가 검색 입력으로 기록될 수 있습니다.
복구 새 조합을 입력하지 않습니다. 버튼과 상태가 명확할 때만 기록 버튼으로 끄고 검색 원문을 대조합니다. 상태가 불명확하면 중단합니다. Esc는 상태에 따라 검색 지우기가 될 수 있으므로 일반적인 탈출 키로 쓰지 않습니다.
재합류 기록 종료와 원문 보존을 확인한 뒤 2단계
소스 필터와 행 표시가 맞지 않을 때
먼저 확인 읽은 문자열, 따옴표, UI 언어, 실제 열 이름을 다시 봅니다. 활성 프로필·확장·사용자 키바인딩 차이도 남겨 둡니다.
복구 한 행의 이름만으로 전체 조건을 단정하지 않습니다. 정확한 구문 의미를 확보하지 못하면 해석을 보류합니다. 행 더블 클릭·Enter로 확인하려 하지 않습니다.
재합류 1단계에서 대상 화면을 다시 확인하고 3~5단계에서 조건과 행을 대조합니다.
6. 핵심 정리와 공식 자료
- 같은 바로 가기 키 화면도 검색 원문에 따라 다른 범위의 목록을 보여 줍니다.
- 소스 제한과 나머지 검색 내용을 읽은 뒤 결과 행의 소스와 대조합니다.
- 검색어를 바꾸지 않고 설명할 수 있으면 이번 편의 목표에 도달한 것입니다.
공식 자료
대상 기준 시점은 2026년 10월 5일 19:00 KST입니다. 공식 자료는 같은 날 19:03~19:08 KST에 확인했습니다. 구현은 기준 시점 이전 공개된 Stable 1.140.0 소스를 기준으로 했습니다. 문서에 별도 발행일이 표시되지 않은 경우 확인 시점을 기준으로 삼았습니다.
정상 결과와 복구 설명은 공식 문서·소스에 따른 예상입니다. 이 글은 Windows 실기 수행을 관찰한 결과를 제시하지 않습니다. 자신의 버전과 화면이 다르면 무리하게 맞추지 말고 확인 기준에 따라 중단하거나 분기하세요.
- 1. 바로 가기 키 편집기와 검색 · Microsoft
- 2. Stable 1.140 릴리스 · Microsoft
- 3. 검색 구문과 필터 처리 · Microsoft
- 4. 검색창·기록 모드·정렬과 결과 목록 · Microsoft
- 5. 검색 초점과 검색 지우기 단축키 · Microsoft
- 6. 키 조합 검색의 공식 테스트 · Microsoft
- 7. 한국어 UI 번역 · Microsoft
- 8. 단축키 변경 입력창의 초점 이탈 취소 · Microsoft
- 9. Ctrl+F 검색 초점 명령 · Microsoft
- 10. 검색창의 기존 텍스트 선택 · Microsoft
- 11. 결과 목록과 접근성 결과 수 안내 · Microsoft
이전 편: 커맨드 팔레트 66부 · 이미 열린 화면에서 초점 이동으로 결과 확인하기
'개발 > Visual Studio Code' 카테고리의 다른 글
| 커맨드 팔레트 69부: 명령 이름과 명령 ID를 구분해 검색하기 (0) | 2026.10.07 |
|---|---|
| 커맨드 팔레트 68부: 검색 결과가 없을 때 검색어와 필터를 나누어 점검하기 (0) | 2026.10.06 |
| 커맨드 팔레트 66부: 이미 열린 화면에서 초점 이동으로 결과 확인하기 (0) | 2026.10.04 |
| 커맨드 팔레트 65부: matched와 Invoking을 읽고 실제 화면으로 완료 확인하기 (0) | 2026.10.03 |
| 커맨드 팔레트 64부: 단축키 로그에서 awaiting more chord(s) 읽기 (0) | 2026.10.03 |
