Substitute ko

치환

jvim은 정규식, 커스텀 구분자, 범위 지정, JSONPath 기반 구조적 치환이 가능한 vim 스타일 치환 명령을 지원합니다.

기본 문법

:[범위]s/패턴/대체문자열/[플래그]

명령	설명
:s/old/new/	현재 줄에서 첫 번째 매치 치환
:s/old/new/g	현재 줄에서 모든 매치 치환
:%s/old/new/g	전체 파일에서 모든 매치 치환
:N,Ms/old/new/g	N~M 줄에서 모든 매치 치환 (1부터 시작)

커스텀 구분자

s 바로 다음의 문자가 구분자가 됩니다. 패턴이나 대체문자열에 /가 포함될 때 유용합니다:

:s#old#new#g         → #을 구분자로 사용
:s|old|new|g         → |을 구분자로 사용
:s@http://@https://@g → @를 사용하여 슬래시 이스케이프 회피

이스케이프된 구분자

패턴이나 대체문자열 안에 구분자 문자가 필요하면 \로 이스케이프합니다:

:s/path\/to/path\/from/g   → "path/to"를 "path/from"으로 치환
:s#a\#b#c\#d#g             → "a#b"를 "c#d"로 치환

이스케이프 처리 로직은 s 이후 텍스트를 스캔하여 파트 배열을 구축합니다: \구분자를 만나면 구분자를 리터럴 문자로 처리합니다.

플래그

플래그	설명
g	전역 — 각 줄에서 모든 발생을 치환 (이것 없이는 줄당 첫 번째 매치만 치환)
i	대소문자 무시 매칭

플래그 조합 가능: :s/old/new/gi

정규식 지원

패턴에서 전체 Python 정규식 문법이 지원됩니다:

:s/(\w+)/[\1]/g          → 각 단어를 대괄호로 감싸기 (그룹 캡처)
:%s/^\s+//g              → 앞쪽 공백 제거
:s/(\d{4})-(\d{2})/\2-\1/g → 연도-월 형식 바꾸기

대체문자열에서 그룹 참조 \1, \2 등이 지원됩니다.

범위 지정

범위	설명
(없음)	현재 줄만
%	전체 파일
N,M	N~M 줄 (1부터 시작, 유효 범위로 클램핑)

:%s/TODO/DONE/g      → 전체 파일
:2,10s/from/to/g     → 2~10번 줄
:1,1s/old/new/       → 첫 번째 줄만

JSONPath 치환

검색 패턴이 $. 또는 $[로 시작하면 원시 텍스트 대신 JSON 구조에 대해 치환합니다. =의 유무와 위치에 따라 세 가지 모드가 결정됩니다:

모드 1: 키 이름 변경

패턴: = 접미사 없는 JSONPath

경로에 매칭되는 JSON 키의 이름을 변경합니다.

:s/$.name/username/g           → 루트에서 "name"을 "username"으로 변경
:s/$..name/label/g             → 모든 깊이의 "name" 키를 재귀적으로 변경
:s/$.users[*].name/fullName/g  → 각 사용자 객체의 "name" 변경

경로의 마지막 세그먼트만 이름이 변경됩니다. 경로는 딕셔너리 키로 해석되어야 합니다 (배열 인덱스가 아님).

모드 2: 무조건 값 치환

패턴: =로 끝나는 JSONPath (필터 값 없음)

매칭 경로의 모든 값을 치환합니다.

:s/$.name=/Bob/g               → 루트 "name" 값을 "Bob"으로 설정
:s/$..status=/active/g         → 모든 "status" 값을 "active"로 설정
:s/$.users[*].age=/0/g         → 모든 사용자 나이를 0으로 초기화
:s/$..enabled=/true/g          → 모든 "enabled"를 true로 설정

모드 3: 조건부 값 치환

패턴: =값 필터가 있는 JSONPath

필터 조건에 맞는 값만 치환합니다.

:s/$..status="draft"/review/g     → "draft" 상태만 "review"로 치환
:s/$..count=0/1/g                 → 0인 카운트를 1로 치환
:s/$..enabled=false/true/g        → 비활성화된 모든 플래그를 활성화

자동 타입 감지

대체 값은 자동으로 타입이 감지됩니다:

입력	감지 타입	JSON 값
null	null	null
true	불리언	true
false	불리언	false
42	숫자	42
3.14	숫자	3.14
hello	문자열	"hello"
"hello"	문자열 (이미 따옴표)	"hello"

감지 로직:

1. null, true, false → 그대로 전달
2. float로 파싱 가능 → 그대로 전달
3. 이미 따옴표로 감싸짐 → 그대로 전달
4. 나머지 → json.dumps()로 JSON 인코딩

위치 중복 제거

JSONPath가 여러 위치에 매칭될 때 치환 엔진은 사용된 위치((행, 열) 쌍)를 추적하여 중복 치환을 방지합니다. 이미 치환된 위치면 (행, 열+1)부터 다음 발생을 검색합니다.

JSONL 치환

JSONL 모드에서 JSONPath 치환은 각 레코드에 독립적으로 동작합니다:

1. 내용이 블록(연속된 비어있지 않은 줄 그룹)으로 분할
2. 각 블록이 별도의 JSON 문서로 파싱
3. JSONPath 해석과 치환이 레코드별로 실행
4. 결과가 블록 시작 오프셋을 사용하여 에디터 라인 위치로 매핑
5. 같은 패턴이 모든 레코드에서 매칭 및 치환 가능

멀티라인 처리

대체 문자열에 줄바꿈(리터럴 \n)이 포함되면:

• 결과가 줄바꿈으로 분할
• 라인 인덱스가 그에 맞게 조정
• 모든 접기와 접힌 문자열이 해제됨 (구조가 변경되었으므로)

Undo

모든 치환은 u로 실행 취소할 수 있습니다. 전체 치환 작업(영향받은 모든 줄)이 단일 undo 포인트로 기록됩니다.

매치가 없으면 undo 스택 항목이 자동으로 제거됩니다 (무동작이 히스토리를 오염시키지 않음).

상태 메시지

상황	메시지
성공	"N substitution(s)"
매치 없음	"Pattern not found: 패턴"
치환 후 잘못된 JSON	"Invalid JSON: 메시지 (line N)"
잘못된 JSONPath	"Invalid JSONPath: 오류"
경로가 컨테이너만 매칭	"JSONPath matches only objects/arrays (not substitutable)"

---

English | 홈