Node.js CLI 스크립트를 Rust로 마이그레이션: AI 활용으로 5~10배 속도 향상
Node.js 18 기반 CLI 스크립트로 프로젝트 파일을 처리했습니다. 재귀적 디렉토리 탐색, 확장자별 줄 수 집계, 프론트 매터 추출을 포함한 마크다운 파싱 작업이었습니다. M4 맥북에서는 실행에 2초가 걸렸지만, 인텔 코어 i5-1035G1(램 8GB) 환경에서는 8초가 소요되었습니다. 반복 실행이 잦은 환경에서는 이 차이가 치명적으로 다가옵니다.
AI 어시스턴트(Claude Code)를 활용해 Rust로 재작성한 결과, 5~10배의 속도 향상을 달성했습니다. 코드는 반복적으로 생성되었습니다. 러스트 컴파일러가 오류를 잡아내면 AI가 수동 개입 없이 이를 수정하는 방식이었습니다.
기술적 배경 및 활용 사례
스크립트는 다음과 같은 일반적인 작업을 처리했습니다.
glob을 활용한 재귀 탐색 및 파일별 줄 수 통계 집계- 마크다운 파싱, 프론트 매터 추출 및 인덱스 생성
병목 현상: 순차적 프로미스 실행과 최적화되지 않은 글로빙(globbing)이었습니다. Node.js도 최적화가 가능하지만, Rust는 파일 탐색 및 CPU 집약적 작업에서 압도적인 강점을 보입니다. grep이나 find보다 10~20배 빠른 ripgrep나 fd가 좋은 예시입니다.
본 실험은 비교적 단순한 작업에 집중했습니다. 각 스크립트는 약 200줄 내외로 구성되었으며, 네트워크 호출, 멀티스레딩, 복잡한 비즈니스 로직은 배제했습니다.
AI 기반 마이그레이션 프로세스
- 원본 소스 코드를 Claude Code에 입력하고 Rust로 포팅하도록 지시했습니다.
- 컴파일러가 타입 불일치 및 라이프타임 문제를 감지하면, AI가 이를 반복적으로 수정했습니다.
- 최종 코드 검토: 논리 검증 및 원본 코드와의 비교에 약 20분을 할애했습니다.
결과적으로 생성된 Rust 코드는 놀라울 정도로 가독성이 높았습니다. 엄격한 타입 시스템이 강력한 피드백 루프를 형성했고, 정확한 컴파일러 오류 메시지가 AI를 위한 자동 코드 리뷰 역할을 했습니다. 수동 디버깅이나 러스트에 대한 심도 있는 전문 지식이 필요하지 않았습니다.
바이너리 배포
Rust 바이너리는 플랫폼별로 빌드되므로 Git 저장소에 보관하기에는 비효율적입니다. 해결책은 esbuild의 방식을 따르는 것입니다. 각 플랫폼용 미리 컴파일된 바이너리를 번들링한 npm 패키지를 제공하는 것입니다. npm install 명령어만 실행하면 소스 코드 노출 없이 해당 환경에 맞는 바이너리를 자동으로 가져옵니다.
벤치마크
| 머신 사양 | Node.js 18 | Rust | 속도 향상 |
|---------------------|------------|----------|-----------|
| i5-1035G1, 램 8GB | ~8초 | 1~1.5초 | 5~7배 |
| 맥북 M4 | ~2초 | ~0.3초 | 약 6배 |
이러한 결과는 파일 I/O와 CPU 집약적 집계 작업이 결합된 경우의 일반적인 수치입니다. 특정 작업에서 최대 1000배의 성능 향상을 보이는 ccusage와 같은 도구와 유사한 패턴입니다.
한계점 및 주의사항
작업 적합성:
- 네트워크 또는 데이터베이스 호출: 성능 향상 없음(Rust가 I/O 대기 시간을 단축시키지는 못함).
- 1초 미만 스크립트: 마이그레이션 노력 대비 효율이 낮음.
- 반드시 먼저 프로파일링:
node --prof또는time명령어로 병목 지점을 확인하세요.
AI 생성 코드의 제약:
- 단순 스크립트에 한정. 복잡한 아키텍처(트레이트, 비동기 처리 등)는 범위를 벗어남.
- AI가 유지보수하는 코드는 기술 부채가 누적될 수 있음.
- AI 접근성이 없는 팀은 코드를 이해하거나 수정하는 데 어려움을 겪을 수 있음.
핵심 요약
- Rust와 AI의 조합은 파일 탐색 및 CPU 집약적 CLI 작업에서 5~10배의 속도 향상을 제공합니다.
- 러스트 컴파일러는 AI 생성 코드의 디버깅을 자동화합니다.
- 플랫폼별 바이너리를 npm으로 배포하는 것은 실용적인 접근 방식입니다.
- 마이그레이션 전 반드시 프로파일링하세요. 이 방식은 단순하고 독립적인 스크립트에 적합합니다.
- 기술 부채 경고: 향후 리팩토링 시 AI에 과도하게 의존할 경우 유지보수 부담이 커질 수 있습니다.
Node.js가 I/O 또는 CPU 병목 현상에 부딪히는 유사한 유틸리티로 이 접근 방식을 확장 적용하기에 적합합니다.
— Editorial Team
아직 댓글이 없습니다.