왜 백업이 필요한가
Windows를 재설치하거나 사용자 프로필이 초기화될 때, 개인화한 터미널 색상, 프로필, 시작 디렉터리, 단축키 등 모든 설정을 잃을 수 있습니다. settings.json을 정기적으로 백업하면 수동 재구성 시간을 절약하고, 여러 장비 사이에서 동일한 환경을 빠르게 재현할 수 있습니다.
중요: settings.json을 백업/복원할 때 Windows Terminal이 실행 중이면 변경사항이 덮어씌워지거나 충돌이 발생할 수 있으니 터미널을 종료한 후 작업하세요.
핵심 위치 한 줄 정리
settings.json 경로: %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState
백업 방법 개요
두 가지 간단한 방법을 제공합니다:
- 파일 탐색기(그래픽) 사용법 — 초보자에게 추천
- 명령 프롬프트(관리자 권한) 사용법 — 스크립트화/자동화에 적합
각 방법의 단계와 추가 팁, 대안(전체 LocalState 폴더 복사, 자동 동기화 대안, OneDrive/로컬 NAS 백업)을 아래에 설명합니다.
파일 탐색기로 Windows Terminal 설정 백업하기
아래 절차는 그래픽 환경에서 settings.json만 백업하는 방법입니다. 전체 폴더를 백업하려면 settings.json 대신 LocalState 폴더 전체를 복사하세요.
- Win + E를 눌러 파일 탐색기(파일 탐색기)를 엽니다. 단축키가 작동하지 않으면 시작 메뉴에서 파일 탐색기를 실행하세요.
- 주소 표시줄에 아래 경로를 붙여넣고 Enter를 누릅니다:
%LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState- 폴더 안에서 settings.json 파일을 찾습니다.
- settings.json 파일을 마우스 오른쪽 버튼으로 클릭하고 복사 아이콘을 선택하거나 Ctrl + C로 복사합니다.
- 백업하려는 대상 폴더(예: 외장 드라이브, OneDrive 동기화 폴더, 네트워크 드라이브)로 이동합니다.
- 빈 공간에 마우스 오른쪽 버튼을 클릭하고 붙여넣기(또는 Ctrl + V)를 선택해 settings.json을 저장합니다.
복사 완료: 이제 선택한 위치에 settings.json 복사본이 보관됩니다.
팁: 파일 이름에 백업 날짜를 덧붙이면 여러 백업을 관리하기 쉽습니다. 예: settings-2025-10-17.json
명령 프롬프트로 Windows Terminal 설정 백업하기
명령어를 이용하면 스크립트로 정기 백업을 자동화할 수 있습니다. 관리자 권한이 필요한 작업은 아니지만, 보호된 위치(예: Program Files)에 쓸 경우 관리자 권한이 필요합니다.
- 작업 표시줄의 Windows 아이콘을 클릭해 시작 메뉴를 엽니다.
- 검색창에 “명령 프롬프트”를 입력하고 필요 시 “관리자 권한으로 실행”을 선택합니다.
- 관리자 권한 명령 프롬프트 창에서 아래 명령을 붙여넣고 Enter를 누릅니다.
copy /y /v %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json 예: C:\Backup 폴더로 백업하려면 다음과 같이 입력합니다:
copy /y /v %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json C:\Backup명령 설명:
- copy: 파일 복사 명령
- /y: 대상 파일이 있을 때 확인 메시지 없이 덮어씀
- /v: 복사된 파일을 검증함
자동화 팁: 위 명령을 .bat 파일로 저장하고 작업 스케줄러에 등록하면 정기 백업을 실행할 수 있습니다.
복원 방법 개요
백업해 둔 settings.json을 원래 위치로 복사하면 됩니다. 복원 전 Windows Terminal이 실행 중이면 먼저 종료하세요. 복원 방법은 파일 탐색기와 명령 프롬프트 두 가지 모두 지원합니다.
파일 탐색기로 복원
- 파일 탐색기에서 백업한 settings.json 파일이 저장된 위치로 이동합니다.
- 파일을 선택한 후 Ctrl + C로 복사합니다.
- 아래 원래 위치로 이동합니다:
%LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState- Ctrl + V로 붙여넣기 합니다. “대상 파일 교체 또는 건너뛰기” 창이 나타나면 “대상 위치의 파일 바꾸기”를 선택해 덮어씁니다.
복원 성공: 터미널을 다시 열면 백업한 설정이 적용되어야 합니다.
명령 프롬프트로 복원
관리자 권한 명령 프롬프트(또는 권한이 충분한 일반 계정)를 열고 아래 명령에서
copy /y /v %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState 예: C:\Backup에 백업해 둔 경우:
copy /y /v C:\Backup\settings.json %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState복원 후 확인: Windows Terminal을 열고 예상 프로필, 색상, 시작 셸이 복원되었는지 확인하세요.
추가 가치: 대안, 자동화, 점검표
대안 방법
- 전체 LocalState 폴더 복사: settings.json 외에 터미널이 생성하는 기타 런타임 파일까지 보존하려면 LocalState 폴더 전체를 백업하세요.
- 버전 관리: Git 저장소(예: 개인 로컬 Git 또는 사설 Git 서버)에 settings.json을 저장하면 변경 이력 관리를 할 수 있습니다. 민감한 데이터(토큰 등)가 포함되어 있지 않은지 확인하세요.
- 클라우드 동기화: OneDrive, Google Drive, NAS 등에 백업 폴더를 두면 장비 간 동기화가 가능합니다(회사 정책/보안 규정 확인 필요).
자동화(샘플 배치 스크립트)
간단한 .bat 예시(설명용):
@echo off
set BACKUP_DIR=C:\Backup\WT
mkdir "%BACKUP_DIR%"
copy /y /v %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState\settings.json "%BACKUP_DIR%\settings-%date:~0,10%.json"(위 스크립트는 Windows 지역 설정에 따라 날짜 포맷이 다를 수 있으니 필요 시 조정하세요.)
역할 기반 체크리스트
- 개발자
- 주요 프로필(예: WSL, PowerShell, CMD) 설정 복원 확인
- 색상 테마 및 글꼴 크기 확인
- 시스템 관리자
- 배포 스크립트에 백업/복원 절차 포함
- 보안 정책(저장 위치 접근 권한) 검토
- 일반 사용자
- 백업 파일 이름에 날짜 포함
- 터미널 종료 후 복원 수행
간단 점검 표 (SOP)
- 백업 전: Windows Terminal을 종료
- 백업: settings.json을 안전한 위치로 복사
- 변경/업데이트: 필요 시 새 버전의 settings.json으로 테스트
- 복원 시: 기존 파일 덮어쓰기 전 원본 백업(항상 두 단계 백업 권장)
언제 이 방법이 실패하는가(경계 사례)
- settings.json에 손상된 JSON 구문이 포함된 경우: 복원 후 Terminal이 구성 로딩에 실패할 수 있습니다. 복원 전에 JSON 유효성 검사를 권장합니다.
- 설정이 레지스트리나 다른 외부 구성 파일을 참조하는 경우: 일부 확장 설정은 settings.json 외부에 저장될 수 있으므로 모든 사용자 설정이 복원되지 않을 수 있습니다.
- 회사 보안 정책으로 특정 폴더에 접근이 차단되면 명령어 복사/붙여넣기가 실패할 수 있습니다.
해결책: 복원 전 JSON 구문 검사, 전체 LocalState 백업, IT 정책 확인.
간단한 점검(테스트 케이스)
- TC1: 백업한 settings.json을 복원한 뒤 예상 프로필 3개가 모두 존재하는지 확인
- TC2: 색상 테마와 글꼴 크기 변경 후 복원해 원상복구되는지 확인
- TC3: 터미널 실행 중 복원 시 경고/충돌 발생 여부 확인
의사결정 흐름(간단 다이어그램)
다음은 백업 방법을 결정할 때의 간단한 흐름입니다:
flowchart TD
A[Windows Terminal 설정 백업 필요?] -->|예| B{초보자인가?}
B -->|예| C[파일 탐색기로 백업]
B -->|아니오| D{자동화/정기 백업 원함?}
D -->|예| E[명령 프롬프트 배치 스크립트 사용]
D -->|아니오| C
A -->|아니오| F[백업 불필요]마무리 요약
- settings.json은 Windows Terminal의 핵심 설정 파일입니다. 위치는 %LocalAppData%\Packages\Microsoft.WindowsTerminal_8wekyb3d8bbwe\LocalState 입니다.
- 파일 탐색기나 명령 프롬프트로 손쉽게 백업/복원이 가능합니다.
- 자동화, 전체 폴더 백업, 버전 관리(Git) 등으로 관리 수준을 높일 수 있습니다.
- 복원 전 항상 터미널을 종료하고 JSON 유효성 검사를 하면 문제를 예방할 수 있습니다.
중요: 민감한 정보(토큰, 자격증명 등)가 settings.json에 저장되어 있는지 확인하고, 있다면 안전한 방법으로 암호화하거나 제외한 다음 백업하세요.
감사합니다. 안전한 백업/복원으로 개인화한 터미널 환경을 잃지 마세요.
