타입스크립트 개발자는 타입 주석을 실제로 읽는가

초록

이 연구는 26명의 학부생을 대상으로 눈동자 추적 실험을 수행해, 타입스크립트 코드에서 타입 주석이 코드 요약 및 버그 위치 찾기 과제 중 개발자들의 시선에 얼마나 영향을 미치는지를 조사했다. 결과는 타입 주석이 존재하더라도 개발자들이 해당 라인을 직접 바라보는 비율이 유의미하게 증가하지 않으며, 작업 성과와도 큰 연관이 없음을 보여준다.

상세 분석

본 논문은 정적 타입 주석이 “인‑코드 문서화” 역할을 수행한다는 가설을 검증하기 위해 눈동자 추적(e‑tracking) 방법을 채택하였다. 실험 설계는 두 가지 주요 과제, 즉 코드 요약(task summarization)과 버그 탐지(task bug‑localization)를 포함했으며, 각 과제마다 타입이 포함된 버전과 타입이 제거된 버전을 교차 설계하였다. 참가자는 총 26명(최종 분석 대상 22명)으로, 대부분이 JavaScript/TypeScript 사용 경험이 평균 4.5년 수준이며, 교육 배경은 고등학교부터 석사까지 다양했다.

눈동자 데이터는 고정시간(dwell time), 고정 횟수(fixation count), 그리고 “reference behavior”(타입 선언 라인을 재참조하는 행위) 등 세 가지 주요 메트릭으로 정량화되었다. 특히 “reference behavior”는 타입 라인을 직접 읽거나, 이전에 읽은 라인을 다시 보는 행동을 의미한다. 결과 분석에서는 두 과제 모두에서 타입 주석이 존재할 때 고정시간이나 고정 횟수가 유의미하게 증가하지 않았으며, 오히려 작업 난이도와 작업 시간에 비례하는 일반적인 시선 이동 패턴만 관찰되었다.

흥미로운 부가 결과는 작업 수행과 작업 기억력(working memory) 점수 사이의 상관관계이다. 높은 작업 기억력 점수를 가진 참가자는 타입 주석이 있을 때 약간 더 많은 고정을 보였지만, 그 차이는 통계적으로 의미 있는 수준에 미치지 못했다. 이는 개발자가 타입 정보를 “필요할 때만” 빠르게 스캔하고, 실제 이해 과정에서는 변수명, 함수 호출 구조, 주석 등 다른 코드 요소에 더 의존한다는 점을 시사한다.

또한, 연구자는 기존 문헌에서 제시된 “타입은 문서화 역할을 한다”는 주장과 달리, 실제 현장에서는 개발자가 타입 정보를 적극적으로 읽지 않으며, 이는 IDE 툴이나 자동 완성 기능이 타입 정보를 시각적으로 강조하거나, 교육 과정에서 타입 주석 활용법을 명시적으로 가르쳐야 할 필요성을 제기한다.

한계점으로는 참가자 풀이 주로 학부생에 국한되었고, 실험 코드가 비교적 짧은 스니펫에 머물렀다는 점을 들 수 있다. 따라서 대규모 프로젝트나 산업 현장에서의 행동 양식과는 차이가 있을 수 있다. 향후 연구에서는 다양한 경험 수준의 개발자를 포함하고, 장기적인 코드 유지보수 작업을 대상으로 눈동자 추적을 확대할 필요가 있다.