포스트

설정 프레임워크는 복사하지 말고 델타만 바꾼다 — LazyVim과 Oh My Tmux!의 두 실패

LazyVim 원본 설정 복사와 tmux 테마 드롭인에서 발생한 업스트림 드리프트·설정 충돌을 비교하고 공식 override 계층을 선택한 과정을 정리한다.

설정 프레임워크는 복사하지 말고 델타만 바꾼다 — LazyVim과 Oh My Tmux!의 두 실패

프레임워크가 잘 동작하는 기본 설정을 이미 제공하는데도, 내 설정을 바꾸려면 먼저 그 기본 설정 전체를 복사해야 할 것처럼 느껴질 때가 있다. 그 순간에는 정확히 같은 결과가 나와 안심하기 쉽다. 하지만 복사본은 업스트림이 바뀐 뒤에도 그대로 남는 별도의 설정 소유자가 된다.

2026년 7월에 LazyVim과 Oh My Tmux!를 만지며 비슷한 문제를 두 번 만났다. 한쪽은 원본을 복사해 오래된 경로를 되살린 경우이고, 다른 쪽은 독립 테마를 덮어씌우려다 두 설정 시스템이 같은 화면을 그리려 한 경우다. 결론은 두 도구가 같다는 것이 아니라, 변경하려는 최소한의 값만 그 도구가 제공하는 경로로 넘겨야 한다는 것이다.

LazyVim: 오늘 같은 사본은 내일의 옛 기본값이다

LazyVim은 lazy.nvim plugin spec을 층별로 모아 기본 테마 등 필요한 설정을 이미 제공한다. 사용자 파일에서 해당 플러그인의 원본 spec 전체를 옮겨 오면 당장은 차이가 없다. 그러나 사용자 쪽 복사본은 이후 업스트림의 수정도 직접 따라가야 한다.

실제 조사에서는 오래전에 복사해 둔 catppuccin 설정의 native_lsp 언더라인 항목과 bufferline 통합 모듈 경로가, 당시 새로운 upstream 설정의 lsp_styles와 catppuccin.special.bufferline 구조와 어긋났다. 특히 과거의 catppuccin.groups.integrations.bufferline을 계속 부르던 사본에서는 특정 catppuccin·bufferline 조합에서 module not found가 발생했다. 이것은 2026년 7월 당시 설치 버전에서 본 드리프트이며, 현재 모든 버전의 catppuccin 모듈 위치를 보증하는 문장이 아니다.

1
2
3
원본 설정 복사 → 처음에는 같은 결과
                 ↓ 업스트림 갱신
내 사본은 이전 경로를 유지 → 새 기본값을 덮고 오류 발생

해결은 더 많은 줄을 복사하는 것이 아니었다. 내가 원본과 다르게 쓰려는 항목이 없다면 그 spec 자체를 없애고 업스트림 기본값을 받는다. 다른 옵션이 필요한 경우에만 좁은 plugin spec을 둔다. 이때 opts와 config 등의 병합·교체 규칙은 같지 않으므로 기계적으로 모든 필드를 재귀 병합한다고 가정하면 안 된다. 이 구조는 LazyVim spec 병합과 의존성 계층과 LazyVim 공식 plugin 설정에서 자세히 다룬다.

Oh My Tmux!: 색만 바꾸려다 상태줄 전체를 중복 소유하기

Oh My Tmux!(OMT)는 .tmux.conf를 기본 엔진으로 두고 .tmux.conf.local의 변수로 동작과 테마를 조정한다. 에디터에서 쓰던 테마를 tmux에도 맞추고 싶어 독립 tmux 테마 파일을 그대로 얹으면, 그 테마와 OMT가 둘 다 상태줄 옵션을 설정하는 주체가 된다. 무엇이 마지막에 적용되는지에 따라 색뿐 아니라 레이아웃·포맷도 달라질 수 있다.

처음에는 OMT의 tmux_conf_theme_colour_* 변수에 원하는 hex 색만 채우는 방법을 고려했다. 이것은 독립 테마를 덮는 것보다는 낫지만, 테마가 바뀔 때마다 tmux 팔레트도 다시 손으로 옮겨야 한다. 결국 위화감의 근원은 tmux가 아니라 터미널과 에디터의 색 소유권이 달랐던 것임을 알았다.

더 나은 선택은 OMT가 제공하던 ANSI 팔레트 변형을 쓰고 터미널 테마가 색을 정하도록 하는 것이었다. tmux의 hex(#...)는 특정 RGB 값을 고정하지만 colour0~colour15는 터미널 ANSI 팔레트를 참조한다. 터미널에서 테마를 바꾸면 tmux도 그 팔레트를 따르며, 상태줄을 그리는 주체는 여전히 OMT 하나다. 당시의 수동 hex 치환안은 채택한 최종 설정이 아니라 중간 시도였다. ANSI 위임도 모든 에디터의 truecolor 테마를 자동 변경하는 것은 아니므로 각각의 색 소유권을 구분해야 한다.

1
2
3
상태줄 구성·배치  → OMT
상태줄에 쓸 ANSI 색 → 터미널 테마
에디터 내부 색      → 에디터 테마

특정 tmux 테마가 반드시 필요하다면 OMT의 테마 역할을 비활성화하고 그 테마에 단독 소유권을 주는 편이 낫다. 두 시스템이 동시에 같은 옵션을 그리게 놓아두지 않는 것이 핵심이다. OMT의 팔레트 변수와 구성은 공식 .tmux.conf.local에서 버전별로 확인한다.

변경 파일이 짧아질수록 업스트림을 따라가기 쉬워진다

원본 복사는 업스트림의 책임을 내 파일로 옮긴다. 외부 드롭인은 소유권이 겹치는 새 프레임워크를 하나 더 추가한다. 델타를 기존 override 경로에 남기면 업스트림이 맡는 영역과 내 선택이 선명하게 갈린다. 업데이트 뒤 문제가 생겼을 때도 내가 바꾼 소수의 값부터 확인하면 된다.

물론 “항상 override만 쓰라”는 말은 아니다. 프레임워크의 구조 자체가 필요와 맞지 않으면 기본값을 끄거나 다른 도구로 옮겨야 한다. 하지만 제공된 기본값을 유지하면서 색이나 한 옵션만 바꾸려는 문제라면, 먼저 누가 이 설정을 소유하는지를 찾는 것이 복사·덮어쓰기보다 안전하다.

이 기사는 저작권자의 CC BY 4.0 라이센스를 따릅니다.