Explorers and Filters

탐색기와 필터

왼쪽 활동 막대의 패널 넷(객체 탐색기 · 파일 검색 · 프로젝트 · 북마크 · 확장)은 같은 규칙을 씁니다.

필터 틀

토글	뜻
Aa	대소문자 구분
ab	단어 단위
(.*)	정규식(잘못된 식이면 틀이 빨개지고 아무것도 안 걸립니다)
폴더 체크(프로젝트만)	경로 포함 — 폴더/이름 경로에 일치(crates/x 같은 검색)
눈 · 점(프로젝트 틀 오른쪽)	숨김 파일 · 점 파일(Windows) 표시 — 파일 대화상자와 같은 설정

토글이 전부 꺼져 있으면 공백으로 나눈 낱말을 전부 포함하는 항목(대소문자 무시)이 걸립니다.

한글은 조합 중에도 걸립니다 — 필터·찾기/바꾸기·파일 검색·북마크 필터 모두 IME가 글자를 완성하기 전의 "ㄱ"·"기"로 "가나"·"긴급"을 찾습니다(자모열 비교: "ㄱ" ⊂ 가 · "기" ⊂ 긴 · "달" ⊂ 닭). 정규식 모드는 글자 그대로입니다.

프로젝트 필터는 뒤에서 열거합니다

필터에 글을 넣으면 아직 펼치지 않은 폴더도 이름을 찾으려고 열거하는데, 이 일은 워커 스레드(설정 Project ▸ 필터 열거 스레드 수 · 기본 4)가 폴더 단위로 나눠 병렬로 하고, 결과는 도착하는 대로 트리에 합쳐집니다 — 키 입력이나 화면이 멈추지 않고, 폴더·파일이 많아도(예: Downloads 1만 개) 끝까지 갑니다. 열거하는 동안 목록 아래에 "열거 중… 폴더 N개"가 보이고, 글을 바꾸면 이전 열거는 취소되고 새로 시작합니다(이미 읽은 폴더는 다시 읽지 않습니다). 읽지 못한 폴더(권한 · 사라짐)는 "읽지 못한 폴더 N개"로 세어지고 로그 창에 경로와 이유가 남습니다(워커가 여럿이어도 한 줄로 병합).

project.scan_max(기본 0 = 무제한)는 트리에 담는 항목 수의 메모리 보호용 상한입니다. 0이 아니면 그 수에서 열거를 멈추고 "N개에서 열거를 멈췄습니다"가 뜹니다 — 그 뒤의 파일은 보지 못했으므로 "일치 없음"이 곧 "없음"은 아닙니다.

타입어헤드 — 글자를 치면 그 이름으로

목록에 포커스가 있을 때(필터 상자가 아니라 목록을 클릭한 상태) 글자를 치면 그 글자로 시작하는 항목으로 바로 이동합니다. 객체 탐색기 · 프로젝트 탐색기 · 북마크 · 아웃라인 네 곳이 같은 규칙입니다.

키	동작
글자	접두를 이어 붙여 첫 일치 항목으로(잠시 멈추면 접두가 비워짐 · explorer.typeahead_timeout)
↑ / ↓	접두를 치는 중이면 일치하는 것들 사이를 순환 · 아니면 한 줄씩
Backspace	접두 한 글자 지우기
Esc	접두 지우기

• 치는 중인 접두는 패널 모서리 작은 상자에 보입니다(위치 = explorer.typeahead_pos).
• 한글: 목록에 포커스가 있으면 입력기(IME) 대신 앱이 한글을 조합합니다. Windows는 한/영 키로 모드를 바꾸고 자판 글자가 자모로 바뀝니다. 필터 상자를 클릭하면 입력기가 다시 켜집니다.
• 프로젝트 탐색기는 OPEN FILES와 트리를 한 목록으로 봅니다 — ↑/↓가 이어지고, OPEN FILES 항목에서 Enter/Space = 그 탭으로.
• 설정 explorer.typeahead*(켜기 · 시간 · 공백·특수문자 허용 · 표시 위치) 한 벌을 네 곳이 같이 씁니다.

객체 상세 패널

객체 탐색기 아래의 한 줄(종류 칩 + 설명)입니다. ▲를 눌러 펼치면 속성·컬럼·인덱스 같은 상세가 보이고, 글꼴·크기는 객체 탐색기와 같습니다.

• 접힌 동안은 설명(코멘트)만 씁니다 — 목록을 빠르게 훑어도 서버에 상세를 묻지 않습니다.
• 펼치는 순간 상세를 채웁니다. 한 번 본 객체는 기억해 둔 것을 바로 보이고, 새로 고침(F5 · 우클릭 Refresh)한 범위나 오래된 것만 다시 읽습니다.

파일 검색 범위와 결과

범위 상자가 비어 있으면 작업 모드에 따라 검색합니다: 파일 모드 = 열린 파일만 · 폴더 모드(nexa-sql <폴더>) = 열린 파일 + 그 폴더 이하 · 프로젝트 모드 = 열린 파일 + 프로젝트 파일이 있는 폴더 + 프로젝트에 추가한 폴더. <current file>(활성 파일의 폴더) · <open files> · 경로 · -*.log(제외)를 콤마로 적으면 그대로 씁니다.

결과 행을 한 번 클릭하면 미리보기 탭(흐린 탭 줄 · 편집하면 정식 탭)으로 열어 그 줄을 선택하고 포커스는 패널에 남습니다(↑/↓로 계속 훑기). 더블클릭 · Enter = 정식 탭 + 편집기 포커스. 이미 열린 탭의 결과는 그 탭으로 갑니다. 파일 행의 셰브론은 프로젝트 탐색기와 같습니다.

선택 규칙

• 빈 곳을 클릭하면 선택이 풀리고 마지막 행에 테두리만 남습니다 → ↑/↓는 그 행에서 시작합니다. 파일 대화상자도 같습니다(폴더 고르기에서 선택을 풀고 [폴더 선택] = 지금 폴더).
• 셰브론은 글꼴 높이의 ›/∨(펼침·머묾 = 본문색) · 읽어서 빈 폴더는 셰브론 없음.

객체 탐색기 루트 아이콘

서버 유형별 아이콘 = 원통 틀 + 대표색 테두리(Oracle 빨강 등) + 이름(ORA/CLE · MS/SQL · PG/SQL · MY/SQL · SQL/ITE · TIB/ERO …). 파일은 crates/nexa-sql/assets/dbms/*.svg이고 나중에 실제 로고로 바꿔도 같은 로더가 그립니다. 모르는 DBMS는 generic 틀 + 프로필 이름의 두 글자.

편집기 탭 색

탭 위쪽 줄 색이 탭 구분을 말합니다 — 미저장 탭(파일이 아닌 스크립트 · 저장 뒤 바뀐 파일) = 경고색 · 저장된 파일 탭 = 강조색 · 미리보기 탭 = 흐린 색. 미저장 탭은 탭 이름 글자에도 같은 색이 입혀져, 활성 탭이 아니거나 창에 포커스가 없어도 구분됩니다.

키	기본	뜻
editor.tab_line_unsaved · editor.tab_line_file · editor.tab_line_preview	빈 값	구분별 줄 색(#RRGGBB · 빈 값 = 위 기본색)
editor.tab_unsaved_text	on	미저장 탭 이름에 색
editor.tab_unsaved_color	빈 값	미저장 탭 이름 색(빈 값 = 미저장 줄 색)

탭 우클릭 메뉴도 구분에 따라 다릅니다(미리보기 = Keep Open · 이름 바꾸기 = 스크립트만 · 파일 위치 열기/프로젝트 탐색기에서 보기 = 파일).

검색 상자의 최근 검색어

찾기/바꾸기(Ctrl+F · Ctrl+H) · 파일 검색(검색어 · 범위) · 프로젝트/북마크/확장/아웃라인 필터 · 설정 창 검색 — 상자마다 최근 검색어를 최대 N개(설정 Files ▸ 검색 상자별 최근 검색어 수 · 기본 20 · 0 = 끔) 기억합니다.

보기 방식(설정 Files ▸ 검색어 이력 보기 방식 · 기본 드롭다운): 상자를 클릭하면 아래에 최근 검색어가 목록(기본 5행 · 설정 "드롭다운 행 수" · 넘치면 오른쪽 스크롤 표시 + 휠)으로 뜹니다. ↑/↓/PgUp/PgDn/Home/End로 옮기고 Enter 또는 클릭으로 넣습니다 · 글자를 치면 그 글이 든 항목만 남습니다 · Esc = 닫기 · 바깥 클릭 = 닫고 그 클릭 진행. 플랫으로 바꾸면 목록 없이 상자 안에서 ↑ = 최근 것부터 오래된 쪽 · ↓ = 새로운 쪽 → 끝에서 치던 글로 복귀(Sublime·VS Code 찾기 상자와 같음).

목록으로 넘어가기: 드롭다운의 마지막 항목(플랫이면 치던 글)에서 ↓를 한 번 더 누르거나 Tab을 누르면 상자 아래 목록(프로젝트 폴더 · 북마크 · 심볼 · 검색 결과 · 설정 분류 트리)의 첫 행으로 포커스가 옮겨집니다. 기록되는 때 = Enter로 찾기/검색을 실행할 때 · 필터 상자는 글을 넣고 다른 곳을 클릭할 때(포커스를 잃을 때). 같은 글은 앞으로 옮겨지고 중복은 없습니다. 이력은 프로그램 전역(프로젝트·폴더와 무관)으로 사용자 설정 폴더의 search-history.json에 저장되어 다시 켜도 남습니다.

파일 검색의 제외 로그

파일 검색은 크기 상한(설정 search.max_file_kb · 기본 1 MB)을 넘는 파일 · 이진 파일(첫 8 KB에 NUL) · 읽지 못한 파일 · 이름이 UTF-8이 아닌 파일을 건너뛰고, 결과 아래 "Skipped (N)" 행에 모아 둡니다(클릭 = 경로 — 이유 펼침 · 상태줄 끝 "· N skipped"). 워커 여럿이 병렬로 검색해도 로그는 한 줄로 병합돼 도착 순으로 보입니다. CLI nsql grep은 끝에 skipped N file(s): too_large 2 · binary 3 요약을 stderr로 내고, NSQL_GREP_LOG=1이면 파일 목록까지 냅니다.

검색 입력란의 × 지우기

찾기/바꾸기 · 파일 검색(검색어 · 범위) · 프로젝트/북마크/확장/아웃라인 필터 · 접속 창 필터 · 설정 검색 · 트랜잭션 로그 검색 · 명령 팔레트 — 글을 넣으면 상자 오른쪽 끝에 ×가 나타나고, 클릭하면 글이 비워지며 목록·찾기가 바로 원래대로 돌아옵니다. 빈 상자에는 보이지 않습니다.

파일 검색 범위에 조건 넣기

범위 상자 한 줄에 조건을 콤마로 잇습니다 — 경로(D:\proj) · <open files> · 포함 *.sql(글롭 · +pat도 같음) · 제외 -*.log. 포함이 하나라도 있으면 그중 하나에 맞는 파일만(OR) 읽고, 제외에 걸리면 뺍니다(AND NOT). 폴더는 늘 내려가므로 폴더를 빼려면 -폴더/. 패턴만 적고 경로가 없으면 기본 범위(열린 탭 + 작업 모드 폴더)에 패턴만 얹습니다.

예: *.sql, *.txt, -*_test.sql, D:\proj = D:\proj 아래 .sql·.txt 중 _test.sql이 아닌 파일. 글롭은 .gitignore와 같은 문법(* ** ?). CLI는 nsql grep SELECT D:\proj -g *.sql -g *.txt --exclude *_test.sql.