Yeop's Essentials

VS Code에서 반복 편집을 편하게 해 주는 도구 모음입니다. 여러 곳에 번호를 넣거나, 선택한 내용을 교체하고, 숨겨진 파일을 잠시 확인할 수 있습니다. yeopnokai 다크 테마도 함께 제공합니다.

설치하고 시작하기

VS Code 1.95 이상에서 사용할 수 있습니다.

1. VS Code의 확장 화면을 엽니다.
2. 오른쪽 위 **… → VSIX에서 설치… (Install from VSIX…)**를 선택합니다.
3. 내려받은 yeops-essentials-버전.vsix 파일을 선택합니다.
4. 설치 후 다시 로드 안내가 나오면 실행합니다.

F1을 눌러 명령 팔레트를 열고 Yeop을 검색하면 사용할 수 있는 명령이 나옵니다. 편집 기능을 사용하려면 먼저 파일을 열고 바꿀 내용을 선택하세요.

기능 한눈에 보기

macOS에서는 위 단축키의 Ctrl을 Cmd로, Alt를 Option으로 바꿔 사용하세요.

숫자·문자를 순서대로 채우기

Increment Selection은 첫 번째 선택 내용을 기준으로 나머지 선택 영역을 채웁니다. 기본 순서는 문서의 위에서 아래입니다.

1. 바꿀 숫자나 문자를 여러 곳에서 선택합니다.
2. Ctrl+Alt+I를 누릅니다.
3. 첫 선택이 1이면 1, 2, 3…, A이면 A, B, C…로 채워집니다.

Ctrl+Alt+Shift+I를 누르면 감소하는 순서로 채웁니다.

명령 팔레트에서 다음 명령도 사용할 수 있습니다.

• Number from Zero: 선택 내용을 0, 1, 2…로 채웁니다.
• Reverse Order: 선택한 내용의 순서를 뒤집습니다. A / B / C → C / B / A

선택한 내용끼리 자리 바꾸기

두 곳 이상을 선택한 뒤 Ctrl+T를 누르면 내용이 다음 선택 위치로 한 칸씩 이동합니다.

• 두 곳 선택: A / B → B / A
• 세 곳 선택: A / B / C → C / A / B

글자를 선택하지 않고 여러 커서만 놓았다면 각 커서 위치의 단어를 교체합니다. 이 단축키는 여러 곳을 선택했거나 커서가 여러 개일 때 동작합니다.

대소문자 형태 유지하기

대소문자만 다른 단어를 여러 곳에서 선택하고 새 내용을 입력하면 각 위치의 대소문자 형태를 유지합니다.

예를 들어 value / Value / VALUE를 함께 선택한 뒤 count를 입력하면 count / Count / COUNT가 됩니다. 붙여넣기에도 적용됩니다.

숨겨진 파일 확인하기

폴더를 연 상태에서 Ctrl+Shift+A를 누르면 탐색기에서 숨긴 파일을 표시합니다. 한 번 더 누르면 원래 숨김 상태로 돌아갑니다. 탐색기 위쪽의 눈 모양 버튼으로도 사용할 수 있습니다.

처음 사용할 때 별도로 지정한 제외 목록이 없으면 다음 폴더를 기본 목록에 추가합니다. 하위 폴더에도 적용됩니다.

• node_modules
• __pycache__
• .venv
• .pytest_cache, .mypy_cache, .ruff_cache

첫 실행에서는 파일을 표시하고, 다시 눌러 복원하면 이 목록에 따라 숨깁니다. 기존에 지정한 제외 목록은 유지합니다. 사용 후 files.exclude를 빈 객체({})로 남겨 두면 기본 목록을 다시 추가하지 않습니다. .vscode/settings.json이나 files.exclude 설정 자체를 삭제하고 다른 설정 범위에도 제외 목록이 없으면, 다음 표시 실행 시 기본 목록을 다시 추가합니다. 표시 중 삭제하여 복원용 백업이 남아 있다면 첫 토글은 백업을 정리하고, 그다음 토글에서 기본 목록을 적용합니다.

이 기능은 VS Code의 Files: Exclude 설정을 전환합니다. .gitignore는 변경하지 않으므로, Git 무시 설정 때문에 숨겨진 파일은 계속 보이지 않을 수 있습니다.

선택한 위치를 차례로 편집하기

Tab Through Selections를 사용하면 여러 위치를 저장해 두고 하나씩 이동하며 편집할 수 있습니다.

1. 편집할 위치를 여러 곳에서 선택합니다.
2. Ctrl+Shift+U를 누릅니다.
3. Tab으로 다음 위치, Shift+Tab으로 이전 위치로 이동합니다.
4. 편집을 마치면 Esc를 누릅니다.

GitHub Desktop으로 열기

GitHub Desktop이 설치되어 있다면 Ctrl+Shift+Alt+G를 눌러 현재 파일이나 열린 폴더의 Git 저장소를 열 수 있습니다. 상태 표시줄의 GitHub Desktop 버튼으로도 실행할 수 있습니다.

선택 내용을 한 번에 변환하기

Map Selection은 JavaScript 함수를 사용해 선택한 내용을 바꾸는 기능입니다.

1. 변환할 내용을 선택합니다.
2. 명령 팔레트에서 Yeop / Map Selection: Apply JavaScript를 실행합니다.
3. 아래 예시처럼 함수를 입력하고 미리보기로 결과를 확인합니다.
4. Enter로 적용하거나 Esc로 취소합니다.

미리보기 중에도 입력한 함수가 실행됩니다. 직접 작성하거나 내용을 확인한 함수만 사용하세요. 신뢰하지 않는 작업 영역에서는 이 기능을 사용할 수 없습니다.

yeopnokai 다크 테마 사용하기

1. F1을 눌러 명령 팔레트를 엽니다.
2. **색 테마 (Preferences: Color Theme)**를 검색해 실행합니다.
3. yeopnokai를 선택합니다.

어두운 배경에 초록·노랑·분홍 계열의 구문 강조를 사용하는 테마입니다.

내게 맞게 설정하기

명령 팔레트에서 Yeop's Essentials: Configure Tools를 실행하면 이 확장의 설정이 열립니다.

• 쓰지 않는 편집 기능은 각각 끌 수 있습니다.
• 숫자 채우기·자리 바꾸기 등에 사용할 선택 순서를 바꿀 수 있습니다.
• JavaScript 변환 미리보기를 켜거나 끌 수 있습니다.
• 탐색기의 숨김 파일 버튼과 GitHub Desktop 상태 표시줄 버튼을 조정할 수 있습니다.

단축키를 바꾸려면 VS Code의 **바로 가기 키 (Keyboard Shortcuts)**에서 Yeop을 검색하세요.

자주 묻는 질문

명령이 보이지 않거나 단축키가 동작하지 않아요

Configure Tools에서 해당 기능이 켜져 있는지 확인하세요. 자리 바꾸기처럼 여러 선택 영역이 필요한 기능은 실행 조건을 충족해야 합니다. 다른 확장과 단축키가 겹친다면 바로 가기 키에서 변경할 수 있습니다.

편집 결과를 되돌리고 싶어요

VS Code의 실행 취소를 사용하세요. Windows / Linux는 Ctrl+Z, macOS는 Cmd+Z입니다. 숨겨진 파일 표시는 Ctrl+Shift+A를 다시 눌러 복원합니다(macOS: Cmd+Shift+A).

라이선스

MIT License. 자세한 내용은 확장에 포함된 LICENSE 파일을 참고하세요.

참고한 프로젝트

이 도구 모음은 다음 프로젝트의 아이디어를 참고해 별도로 구현했습니다.

• Increment Selection
• map-replace.js
• Open in GitHub Desktop
• Toggle Excluded Files
• Yeop's Swap Selection
• tab-through-selections
• Multiple cursor case preserve