코드 주석과 문서화 문자열(Docstrings): 주석만 번역하고 코드에는 영향을 주지 않는 방법은?
핵심 현황 진단
“소스 코드 파일을 번역기에 직접 넣으면 변수명이나 주요 논리 키워드(if/for)까지 번역되어 코드가 망가지기 쉽습니다.”
근본 원인 분석
1
AST(추상 구문 트리) 수준의 인식
AI 솔루션은 단순한 정규식 매칭을 넘어, 경량화된 구문 분석 기능도 제공합니다. Python의 경우 `'''...'''`로 둘러싸인 Docstring을 정확하게 식별할 수 있습니다. Java/JS의 경우 `/**...*/` 블록을 인식할 수 있습니다.
2
지시어 보존
주석 블록 내부에서는 `@param`, `@return`, `@author` 등 특정 지시어의 헤드는 그대로 두고, 그 뒤의 설명 부분만 번역하여 Javadoc, Sphinx 등 API 문서 생성 시 올바른 포맷을 유지하도록 보장합니다.
최종 솔루션 요약
오픈소스 프로젝트가 다국어 문서를 신속하게 생성하도록 지원하여, 전 세계 개발자들의 기여 장벽을 낮춥니다.