한글 변수명 추천 · Korean Variable Namer
한국어 → 영어 변수명을 추천하는 VS Code 확장 프로그램입니다. 게임 개발(Unity/C#) 및 일반 개발에 자주 쓰는 용어를 우선 지원합니다.
주요 기능
최대 체력 → maxHealth, maxHp, MaxHealth, max_health, MAX_HEALTH남은 적 수 → remainingEnemyCount플레이어 이동 속도 → playerMoveSpeed공격 가능 여부 → canAttack- 한국어 문장 → 영어 일반 번역 및 복사/삽입
- 한국어 코드를 선택한 다음 우클릭 → 한글 변수명: 영어 변수명 추천 및 삽입
- 에디터에서
Ctrl+Alt+N (macOS Cmd+Alt+N) 으로 바로 실행
- 오른쪽 아래 상태 표시줄의 한→EN 버튼 사용
- API 키 불필요. 내장 사전에 없는 표현은 사용자의 동의를 받은 후 MyMemory 번역 API 이용 가능
설치 방법
바로 설치하기 (.vsix)
- VS Code의 왼쪽 확장(Extensions) 탭 열기 (
Ctrl+Shift+X).
- 확장 탭 오른쪽 상단의 … 메뉴 → VSIX에서 설치(Install from VSIX...) 선택.
- 배포된
korean-variable-namer-0.1.0.vsix 파일 선택.
- 필요하면 VS Code 창 새로고침.
또는 터미널에서:
code --install-extension korean-variable-namer-0.1.0.vsix
소스 코드로 실행
- 이 폴더를 VS Code에서 엽니다.
F5 키를 누르면 Extension Development Host가 열립니다.- 새 창에서 명령 팔레트(
Ctrl+Shift+P) → Korean Variable Namer 검색.
외부 npm 라이브러리가 필요하지 않습니다. Node.js가 있다면 npm test로 네이밍 로직을 테스트할 수 있습니다.
사용법
1) 한국어를 입력해 변수명 만들기
- 명령 팔레트(
Ctrl+Shift+P)에서 한글 변수명: 영어 변수명 추천 및 삽입 실행.
- 예:
다음 웨이브, 수류탄 쿨타임, 적 생성 위치 입력.
- 추천 목록에서 원하는 영문 변수명을 선택.
- 선택한 이름이 현재 커서 위치에 삽입됩니다. 이미 한국어 텍스트를 선택했다면 그 영역을 교체합니다. 에디터가 열려 있지 않으면 복사합니다.
2) 변수명만 복사하기
명령 팔레트 → 한글 변수명: 영어 변수명 추천 및 복사.
3) 일반 한→영 번역하기
명령 팔레트 → 한글 변수명: 한국어 → 영어 일반 번역.
영어 결과를 클립보드에 복사하거나 선택 영역과 교체할 수 있습니다.
설정
VS Code 설정(Ctrl+,)에서 Korean Variable Namer 검색 또는 settings.json에 다음처럼 추가:
{
"koreanVariableNamer.defaultStyle": "camelCase",
"koreanVariableNamer.translationProvider": "auto",
"koreanVariableNamer.showStatusBar": true
}
| 설정 |
의미 |
defaultStyle |
camelCase / PascalCase / snake_case / SCREAMING_SNAKE_CASE |
translationProvider: auto |
로컬 사전 우선, 미등록 표현만 온라인 번역 시도 (기본값) |
translationProvider: offline |
온라인 전송 없이 로컬 사전만 사용 |
translationProvider: mymemory |
온라인 번역 우선, 실패 시 로컬 사전 사용 |
showStatusBar |
하단 한→EN 버튼 표시 여부 |
개인정보 및 한계
- 내장 사전은 완전히 오프라인에서 동작합니다.
- 온라인 번역이 필요할 때 최초 한 번 명시적으로 동의를 구합니다. 이때 입력한 문구(또는 선택 영역)만
https://api.mymemory.translated.net/get으로 전송합니다. 코드 전체를 스캔해서 전송하지 않습니다.
- 온라인 기능은 제3자 MyMemory 서비스의 가용성·번역 품질·사용량 제한에 영향을 받습니다. MyMemory API 문서 참고.
- 무료 익명 사용량은 제공자 정책에 따라 제한됩니다. 미등록 표현은 오프라인 상태에서 번역되지 않을 수 있습니다.
- 온라인 사용 동의를 변경하려면 명령 팔레트에서
한글 변수명: 온라인 번역 동의 초기화를 실행하세요.
- 일부 온라인 자동 번역 표현은 프로그래밍 용어와 어긋날 수 있으므로 코드에 반영하기 전에 확인하세요.
- 현재 버전은 한글 → 영어 중심이며, 프로젝트 전체 심볼 자동 Rename은 제공하지 않습니다. 선택 영역/커서에 텍스트를 삽입하거나 교체합니다.
라이선스
MIT. 이 프로젝트는 독립적인 개인 개발용 프로토타입입니다.
| |
