VS Code Profiles 2부: 설정 동기화와 안전한 공유 가이드

VS Code 초보자 시리즈 · Profiles 2부

Profiles 동기화와
안전한 내보내기·공유

Web Study 프로필을 점검하고 파일로 내보낸 뒤 다시 가져오며, 다른 PC 동기화와 충돌 복구까지 익힙니다.

1부에서는 업무 환경을 건드리지 않고 Web Study 프로필을 만든 뒤 vscode-profile-practice 폴더와 연결했습니다. 이번에는 그 환경을 잃어버리지 않도록 백업하고, 다른 컴퓨터 또는 다른 사람에게 옮길 수 있는 형태로 준비합니다. 계정 동기화와 파일 공유의 차이부터 천천히 시작하겠습니다.

목차

1. 1부 복습과 오늘의 목표
2. 동기화·내보내기·전체 적용의 차이
3. Web Study 프로필 점검하기
4. 공유할 내용을 먼저 선별하기
5. 프로필을 파일로 내보내기
6. 내보낸 프로필 다시 가져오기
7. Settings Sync로 다른 PC에 옮기기
8. GitHub Gist 링크로 공유하기
9. 자주 하는 실수와 복구 방법
10. 직접 해보는 연습 과제
11. 핵심 정리와 다음 편 예고

1. 1부 복습과 오늘의 목표

Profile은 프로젝트 파일이 아니라 VS Code의 개인 작업 환경입니다. 설정, 단축키, Snippets, Tasks, 확장 기능, 화면 구성을 목적별로 묶고 빠르게 전환할 수 있습니다. 공식 문서는 프로필을 다른 컴퓨터로 동기화하거나 파일·링크 형태로 내보내 공유하는 방법도 제공합니다. VS Code Profiles 공식 문서

이번 실습에서 완성할 결과

단계	만드는 결과	정상 확인
점검	Web Study의 설정 목록 확인	@modified로 변경값 표시
백업	Web-Study.code-profile	지정한 폴더에 파일 생성
가져오기	Web Study Copy	원본과 같은 설정 확인
동기화	Settings Sync에서 Profiles 선택	동기화 대상 목록에 Profiles 표시

처음 읽는 분도 괜찮습니다 Web Study 프로필이 없다면 Profiles 편집기에서 New Profile → Empty Profile을 선택해 같은 이름으로 만든 뒤 진행하세요. 글자 크기 16, 줄 바꿈 켜기, 자동 저장을 User 설정에 적용하면 1부와 같은 출발점이 됩니다.

2. 동기화·내보내기·전체 적용의 차이

세 기능은 모두 “같은 설정을 다시 사용한다”는 점에서 비슷해 보이지만 대상과 목적이 다릅니다.

기능	대상	사용 시점	핵심 특징
Settings Sync	내 계정의 여러 컴퓨터	집·회사 PC에서 같은 환경 사용	로그인 후 자동 동기화
Profile 내보내기	파일 또는 공유 링크	백업하거나 다른 사람에게 전달	보낼 항목을 검토·선별
Apply to all Profiles	한 VS Code 안의 모든 프로필	모든 환경에 같은 설정·확장 적용	프로필 간 공통 항목 지정

Settings Sync는 설정, 단축키, 사용자 Snippets, 사용자 Tasks, UI 상태, 확장 기능, Profiles를 지원합니다. 반면 Profile 내보내기는 특정 프로필을 하나의 공유 단위로 준비하는 기능입니다. Settings Sync 지원 항목 공식 안내

프로젝트 파일은 별도입니다 Profile을 동기화하거나 내보내도 index.html, style.css, app.js 같은 프로젝트 파일 자체가 함께 이동하는 것은 아닙니다. 프로젝트는 Git이나 파일 복사처럼 별도의 방법으로 옮겨야 합니다.

이번 글에서 사용하는 단축키

기능	Windows	macOS	사용 시점
명령 팔레트	Ctrl + Shift + P	⇧ + ⌘ + P	Profile·Sync 명령 실행
Settings 열기	Ctrl + ,	⌘ + ,	변경 설정 확인
Extensions 열기	Ctrl + Shift + X	⇧ + ⌘ + X	프로필별 확장 확인
Keyboard Shortcuts	Ctrl + K, Ctrl + S	⌘ + K, ⌘ + S	공유 전 사용자 단축키 확인

위 조합은 2026년 7월 26일 기준 공식 기본 단축키 문서에서 확인했습니다. VS Code 기본 단축키 공식 문서

3. Web Study 프로필 점검하기

내보내기 전에 현재 프로필과 그 안에 들어 있는 구성을 먼저 확인합니다. 잘못된 프로필을 내보내는 실수를 막는 단계입니다.

1단계: Web Study로 전환하기

1. vscode-profile-practice 폴더를 VS Code에서 엽니다.
2. 제목 표시줄 또는 Activity Bar 아래 Manage 버튼에서 Web Study를 확인합니다.
3. 다른 프로필이라면 명령 팔레트에서 Profiles: Switch Profile을 실행하고 Web Study를 선택합니다.

정상 결과 Web Study의 아이콘과 이름이 표시되고, 1부에서 선택한 테마와 글자 크기가 적용됩니다. Default Profile에서는 이름이 보이지 않는 것이 정상입니다.

2단계: 변경한 User 설정 확인하기

1. Windows는 Ctrl+,, macOS는 ⌘+,를 누릅니다.
2. Settings 상단에서 User 탭을 선택합니다.
3. 검색창에 @modified를 입력합니다.
4. 글자 크기, 줄 바꿈, 자동 저장 등 의도한 항목만 있는지 확인합니다.

1부 실습을 그대로 진행했다면 설정은 다음과 비슷합니다.

{
  "editor.fontSize": 16,
  "editor.wordWrap": "on",
  "files.autoSave": "afterDelay",
  "editor.minimap.enabled": false
}

Settings 편집기의 @modified 필터는 기본값과 달라진 설정을 찾을 때 사용합니다. 수정한 설정 찾기 공식 문서

3단계: 단축키와 확장 기능 확인하기

1. Keyboard Shortcuts를 열어 사용자가 직접 바꾼 조합이 있는지 확인합니다.
2. Extensions 화면을 열어 Web Study에만 필요한 확장 기능이 있는지 확인합니다.
3. 공유하면 안 되는 조직 전용 확장이나 불필요한 항목이 있다면 내보내기 대상에서 제외할 계획을 세웁니다.

점검 기준 “내가 다른 PC에서도 그대로 쓰고 싶은가?”, “다른 사람이 받아도 되는가?” 두 질문에 모두 그렇다고 답할 수 있는 항목만 공유 대상으로 남깁니다.

4. 공유할 내용을 먼저 선별하기

Profiles 편집기는 프로필을 만들거나 내보낼 때 포함된 구성을 확인할 수 있게 합니다. 현재 공식 문서에서는 설정, 단축키, MCP 서버, Snippets, Tasks, 확장 기능 등의 일부만 선택하는 부분 프로필도 지원합니다. 프로필 구성 항목 공식 안내

항목	Web Study 백업	다른 사람에게 공유	확인할 점
Settings	포함 권장	내용 확인 후 포함	개인 경로·조직 전용 값
Keyboard Shortcuts	필요하면 포함	선택 사항	운영체제와 키보드 차이
Snippets	포함 권장	민감 문자열 확인	개인 URL·토큰이 없는지
Tasks	필요하면 포함	실행 명령 확인	로컬 경로·외부 명령
Extensions	포함 권장	필요한 것만 포함	조직 전용·유료 확장 여부

VS Code 1.81부터 일부 구성만 포함하는 부분 프로필과, 설정·확장 기능을 모든 프로필에 적용하는 기능이 제공됩니다. VS Code 1.81 부분 프로필 릴리스 노트

공유 전에는 반드시 내용 확인 기기별 설정은 내보내기에서 제외되지만, 이것만 믿고 파일을 바로 전달하면 안 됩니다. Settings, Snippets, Tasks 안에 개인 경로, 내부 서버 주소, 토큰이나 계정 정보처럼 공개하면 안 되는 문자열이 없는지 직접 확인하세요.

5. 프로필을 파일로 내보내기

먼저 계정이나 인터넷 연결 없이도 보관할 수 있는 로컬 파일 방식으로 백업합니다. 내보낸 Profile 파일의 확장자는 .code-profile입니다. 로컬 Profile 파일 공식 안내

1단계: 백업 폴더 만들기

프로젝트와 Profile 백업을 섞지 않도록 문서 폴더 아래에 별도 폴더를 만듭니다.

Documents/
├── vscode-profile-practice/
│   ├── index.html
│   ├── style.css
│   └── app.js
└── vscode-profile-backup/
    └── Web-Study.code-profile

2단계: Export 실행하기

1. Manage 버튼 또는 File → Preferences → Profiles로 Profiles 편집기를 엽니다.
2. Web Study 프로필의 더보기 메뉴를 엽니다.
3. Export...를 선택합니다.
4. 표시된 구성 내용을 하나씩 확인하고 백업할 항목만 선택합니다.
5. 저장 위치로 vscode-profile-backup을 선택합니다.
6. 파일 이름을 Web-Study.code-profile로 저장합니다.

정상 결과 백업 폴더에 Web-Study.code-profile 파일이 하나 생깁니다. 원래 Web Study 프로필과 연습 프로젝트는 그대로 유지됩니다.

공식 문서에 따르면 기기별 로컬 경로처럼 다른 컴퓨터에 적용할 수 없는 machine-specific 설정은 Profile 내보내기에 포함되지 않습니다. 내보내기 제외 설정 공식 설명

6. 내보낸 프로필 다시 가져오기

백업은 실제로 복원해 보기 전까지 완성됐다고 보기 어렵습니다. 같은 컴퓨터에서 복사본을 만들어 내보낸 파일이 정상인지 확인합니다.

1단계: Import Profile 열기

1. Profiles 편집기를 엽니다.
2. New Profile 옆의 드롭다운 작업을 엽니다.
3. Import Profile...을 선택합니다.
4. 파일 선택 창에서 Web-Study.code-profile을 선택합니다.

2단계: 내용 검토 후 복사본 만들기

1. 가져오기 화면에서 Settings, 단축키, Snippets, Tasks, Extensions 등 포함 항목을 다시 확인합니다.
2. 이름을 Web Study Copy로 바꿔 원본과 구분합니다.
3. Create를 눌러 새 프로필을 만듭니다.
4. Web Study Copy로 전환하고 Settings에서 @modified를 검색합니다.

Profile 가져오기는 URL 또는 로컬 Profile 파일을 선택한 뒤, 생성 화면에서 항목을 조정하고 Create로 확정하는 순서입니다. Profile Import 공식 문서

정상 결과 Web Study Copy에서 글자 크기 16, 줄 바꿈, 자동 저장 등 내보낸 설정이 보입니다. 이 확인이 끝나면 복사본은 삭제해도 되지만, 원본 Web Study는 그대로 둡니다.

7. Settings Sync로 다른 PC에 옮기기

내가 사용하는 여러 컴퓨터에서 같은 환경을 자동으로 유지하려면 Settings Sync를 사용합니다. Microsoft 계정 또는 GitHub 계정으로 로그인할 수 있습니다.

1단계: 첫 번째 PC에서 동기화 켜기

1. Activity Bar 아래 Manage 또는 Accounts 메뉴를 엽니다.
2. Backup and Sync Settings...를 선택합니다.
3. 동기화 항목 목록에서 Profiles가 선택됐는지 확인합니다.
4. 필요한 Settings, Keyboard Shortcuts, User Snippets, User Tasks, UI State, Extensions도 선택합니다.
5. Microsoft 또는 GitHub 계정으로 로그인합니다.

정상 결과 Manage 메뉴에 Settings Sync가 켜졌다는 상태가 표시되고, 설정 변경이 백그라운드에서 동기화됩니다.

동기화 대상을 나중에 바꾸려면 명령 팔레트에서 Settings Sync: Configure를 실행합니다. 동기화 항목 구성 공식 문서

2단계: 두 번째 PC에서 같은 계정 사용하기

1. 두 번째 PC의 VS Code에서 Backup and Sync Settings...를 엽니다.
2. 첫 번째 PC와 같은 계정으로 로그인합니다.
3. Profiles가 동기화 대상에 포함됐는지 확인합니다.
4. 기존 로컬 설정이 있는 PC라면 Merge·Replace Local·Merge Manually 중 하나를 신중하게 선택합니다.

선택	무슨 일이 생기나요?	초보자 판단 기준
Merge	로컬 설정과 원격 설정을 병합	두 환경을 모두 살리고 싶을 때
Replace Local	원격 설정으로 로컬 설정을 덮어씀	새 PC처럼 로컬 설정이 필요 없을 때만
Merge Manually...	항목을 하나씩 비교·병합	무엇을 남길지 확실하지 않을 때

위 세 선택의 의미는 VS Code 공식 Settings Sync 문서에 명시돼 있습니다. 기존 설정이 있는 컴퓨터에서는 확신이 없다면 수동 병합으로 내용을 비교하는 편이 안전합니다. Merge와 Replace 공식 설명

Remote 환경 예외 SSH, Dev Container, WSL 같은 원격 창으로 또는 원격 창에서 확장 기능을 동기화하지는 않습니다. 데스크톱 프로필에 확장이 있다고 해서 원격 환경에도 자동 설치됐다고 판단하면 안 됩니다. Profile 동기화 제한 공식 안내

8. GitHub Gist 링크로 공유하기

수강생이나 동료가 직접 가져오게 하려면 Profile을 GitHub Gist 링크로 내보낼 수도 있습니다.

1. Profiles 편집기에서 Web Study의 Export...를 선택합니다.
2. 공유할 구성 항목을 검토하고 필요 없는 항목은 제외합니다.
3. GitHub 저장 방식을 선택하고 로그인합니다.
4. 생성된 링크를 복사합니다.
5. 받는 사람은 링크에서 내용을 검토한 뒤 VS Code Desktop으로 가져올 수 있습니다.

공식 문서에 따르면 생성된 Gist는 Secret으로 표시되며 링크를 가진 사람이 접근하는 방식입니다. VS Code for the Web에서는 확장 기능을 계속 사용하려면 사용자가 직접 설치해야 합니다. GitHub Gist Profile 공유 공식 안내

Secret은 비밀번호 보호가 아닙니다 링크가 외부에 전달될 수 있다는 전제로 구성 내용을 검토하세요. 조직 전용 설정이나 공개하면 안 되는 문자열이 있다면 공유 링크 대신 필요한 항목만 정리한 별도 Profile을 만드는 편이 좋습니다.

9. 자주 하는 실수와 복구 방법

실수 1: 두 번째 PC에서 Replace Local을 잘못 선택했습니다

증상 두 번째 PC에서 사용하던 로컬 설정이 원격 설정으로 바뀝니다.

1. 명령 팔레트에서 Settings Sync: Show Synced Data를 실행합니다.
2. Settings, Extensions 등 필요한 항목의 이전 버전을 확인합니다.
3. 필요하면 백업 버전을 복원합니다.

VS Code는 동기화 중 로컬·원격 환경 설정의 백업을 보관하고, Show Synced Data에서 확인할 수 있게 합니다. 현재 공식 문서 기준 로컬 백업은 30일 후 자동 삭제되며 원격 백업은 각 리소스의 최신 20개 버전을 유지합니다. Settings Sync 복원 공식 문서

실수 2: 같은 설정을 두 PC에서 다르게 바꿔 충돌했습니다

복구 선택 내용부터 비교해야 한다면 Show Conflicts를 선택합니다.

버튼	결과	주의
Accept Local	현재 PC 값으로 원격 값을 덮어씀	다른 PC의 변경이 사라질 수 있음
Accept Remote	원격 값으로 현재 PC 값을 덮어씀	현재 PC의 변경이 사라질 수 있음
Show Conflicts	Diff에서 두 값을 비교	초보자에게 가장 확인하기 쉬움

Settings Sync 충돌 처리 공식 문서

실수 3: Profiles가 다른 PC에 나타나지 않습니다

1. 두 PC가 같은 Microsoft 또는 GitHub 계정인지 확인합니다.
2. Settings Sync: Configure에서 Profiles가 선택됐는지 확인합니다.
3. Stable과 Insiders를 함께 사용한다면 기본적으로 서로 다른 Sync 서비스를 사용한다는 점을 확인합니다.

실수 4: 내보낸 Profile에 일부 설정이 없습니다

내보내기 화면에서 해당 구성을 제외했거나, 다른 컴퓨터에 적용할 수 없는 기기별 설정일 수 있습니다. 원본 Profile의 Settings에서 @modified를 확인하고, 다시 Export하면서 포함 항목을 검토하세요.

실수 5: 모든 프로필의 테마가 똑같아졌습니다

해당 테마 설정에 Apply Setting to all Profiles가 적용됐을 수 있습니다. Settings에서 테마 설정의 톱니바퀴 메뉴를 열고 전체 적용을 해제한 뒤, 각 Profile에서 원하는 테마를 다시 선택합니다. 모든 프로필 적용 기능은 필요할 때 해제할 수 있습니다. 모든 Profile에 설정 적용 공식 안내

실수 6: 동기화가 실패하지만 이유를 모르겠습니다

명령 팔레트에서 Output을 열고 Log (Settings Sync) 채널을 확인합니다. 인증 문제라면 Account 출력도 함께 확인합니다. 공식 문서는 Sync 문제를 보고할 때 이 로그를 포함하도록 안내합니다. Settings Sync 문제 보고 공식 안내

10. 직접 해보는 연습 과제

아래 과제를 순서대로 끝내면 Profile 백업과 복원의 전체 흐름을 직접 경험할 수 있습니다.

1. 현재 환경 확인: Web Study로 전환하고 Settings에서 @modified를 검색합니다.
2. 백업 만들기: Web-Study.code-profile 파일을 별도 백업 폴더에 저장합니다.
3. 복원 시험: 그 파일을 가져와 Web Study Copy 프로필을 만듭니다.
4. 결과 비교: 원본과 복사본의 글자 크기, 줄 바꿈, 자동 저장, 테마를 비교합니다.
5. 동기화 점검: Settings Sync 설정에서 Profiles가 선택돼 있는지 확인합니다.
6. 충돌 판단 연습: Merge, Replace Local, Merge Manually의 차이를 자신의 말로 적어 봅니다.
7. 공유 전 검사: Export 화면에서 Settings, Snippets, Tasks, Extensions 중 무엇을 제외할지 결정합니다.

완료 기준 로컬 Profile 파일을 내보내고 다시 가져올 수 있으며, Settings Sync와 Profile Export의 차이, Replace Local의 위험, 충돌 시 Show Conflicts를 먼저 확인해야 하는 이유를 설명할 수 있으면 성공입니다.

11. 핵심 정리와 다음 편 예고

• Settings Sync는 내 계정의 여러 컴퓨터에서 Profiles와 환경 설정을 자동으로 유지합니다.
• 로컬 내보내기는 하나의 Profile을 .code-profile 파일로 백업하거나 전달할 때 사용합니다.
• Export와 Import 화면에서는 포함할 설정·단축키·Snippets·Tasks·확장 기능 등을 검토할 수 있습니다.
• 다른 PC에서 처음 Sync를 켤 때 Replace Local을 선택하면 로컬 설정이 덮어써집니다.
• 충돌이 확실하지 않으면 Show Conflicts 또는 수동 병합으로 먼저 비교합니다.
• SSH·Dev Container·WSL 같은 원격 창의 확장 기능은 Desktop Profile과 별도로 확인해야 합니다.

다음 편 예고 · Profiles 3부 프로젝트별 Profile을 더 빠르게 여는 CLI --profile, Temporary Profile로 확장 충돌을 진단하는 방법, 잘못 연결된 폴더를 Default Profile로 되돌리는 방법을 실무 문제 해결 흐름으로 연습합니다.

공식 자료

• Profiles in Visual Studio Code
• Settings Sync
• User and workspace settings
• Default keyboard shortcuts reference
• VS Code 1.81 Release Notes
• VS Code 1.94 Release Notes

공식 문서와 릴리스 노트 확인일: 2026년 7월 26일