코드·데이터·경로 식별자를 안전하게 이름 변경하기

문제 상황

User Display Name을 userDisplayName으로 바꾸는 작업은 단순해 보이지만 실제 이름은 소스 코드, JSON payload, 데이터베이스 컬럼, CSV 가져오기, CSS 선택자, 경로, 파일명, 환경 변수, 문서와 외부 클라이언트를 가로지를 수 있습니다. 변환기는 일관된 후보를 만들 수 있지만 API를 api로 쓸지, 숫자 시작 이름이 유효한지, 대소문자 비구분 파일시스템이 case-only 변경을 기록할지, 이전 URL에 redirect가 필요한지는 알 수 없습니다. 안전한 절차는 후보 생성과 계약 마이그레이션을 분리하고 실제 사용 환경에서 결과를 증명합니다.

이럴 때 사용하세요

• 기존 이름 집합을 camelCase, snake_case, kebab-case 또는 PascalCase 규칙으로 이전할 때
• 스프레드시트·CSV 헤더를 데이터베이스 컬럼, JSON 키 또는 가져오기 필드에 명시적으로 매핑할 때
• 경로, CSS 선택자, 패키지 키, 환경 변수, 파일명 또는 디렉터리 이름 규칙을 정리할 때
• camel 표기, 약어, 공백, 하이픈, 밑줄이 섞인 여러 줄을 합치지 않고 일괄 검토할 때
• 출판사의 실제 편집 규칙을 적용하기 전에 제목 대문자화 초안이 필요할 때

단계

1. 1단계

   이름을 계약으로 보고 사용처 조사

   소스, 테스트, 설정, schema, migration, 문서, analytics, 클라이언트와 저장 데이터를 검색합니다. 내부 참조와 호환성·별칭·redirect·단계적 이전이 필요한 외부 참조를 구분하세요.

2. 2단계

   목표 명명 정책 작성

   문맥별 케이스와 약어, 숫자, Unicode, 예약어, 구분자 규칙을 기록합니다. APIResponse를 apiResponse, api_response 또는 별도 승인 형식 중 무엇으로 만들지 명시하세요.

3. 3단계

   대표 이름을 줄별 후보로 생성

   케이스 변환기에 원본 이름을 한 줄에 하나씩 붙여 넣습니다. 각 출력 줄을 원본과 대응할 수 있도록 순서를 유지하고 2 MiB·100,000줄 한도를 지키세요.

4. 4단계

   단어 경계와 경고 검토

   단어 수, 약어 정규화, 구두점뿐인 줄, 숫자 시작 결과, Unicode 길이 변화를 확인합니다. 구두점을 그대로 유지해야 하면 UPPERCASE 또는 lowercase 결과와 비교하세요.

5. 5단계

   대상 환경에서 유효하지 않은 이름 해결

   예약어, 허용 문자, 최대 길이, 대소문자 구분, 파일시스템 제한, 데이터베이스 quoting, 경로 인코딩을 검사합니다. 예외를 하나의 광범위한 치환 규칙으로 숨기지 마세요.

6. 6단계

   검토 가능한 diff로 변경 적용

   가능하면 언어 인식 rename 기능을 사용합니다. 대소문자 비구분 파일시스템의 case-only 파일 변경은 임시 파일명을 거칩니다. 전체 diff를 보고 무관한 문자열과 생성 파일 변경을 제외하세요.

7. 7단계

   대상 시스템의 호환성 검증

   테스트, 타입 검사, schema·가져오기 검증, 링크 검사, 빌드와 대상 플랫폼 실행을 완료합니다. 소비자와 저장 데이터 이전이 끝날 때까지 별칭, DB migration, API 호환 계층 또는 URL redirect를 유지하세요.

예시

XMLHttp request-id
2026 release

camelCase 후보:
xmlHttpRequestId
2026Release

검토: XMLHttp 약어 정책을 확인하고, 두 번째 값은 숫자로 시작해 유효하지 않을 수 있음

흔한 실수

자주 묻는 질문