함수나 변수 이름을 정할 때 어떤 기준으로 결정하는지, 그리고 그 과정에서의 경험을 나눠 주세요.

팀 프로젝트와 코드 리뷰를 거치면서 이름 짓기가 단순한 습관이 아니라 가독성의 핵심이라는 걸 배웠습니다. 가장 먼저 보는 기준은 이름만 읽어도 이 변수가 무엇인지, 함수가 무엇을 하는지 바로 알 수 있는가입니다. data나 result 같은 단어는 의미를 담지 않아서 코드를 처음 보는 사람이 혼란스러워하는 이름이라는 걸 리뷰 피드백으로 배웠습니다. 범위가 넓은 변수일수록 더 구체적인 이름이 필요하고, 범위가 짧은 지역 변수는 간결하게 써도 되는 경우가 있다는 기준을 갖게 됐습니다. 일관성 측면에서는 같은 개념에 두 가지 이름을 섞어 쓰면 다른 사람이 코드를 볼 때 다른 역할인 줄 오해하는 일이 생긴다는 걸 경험했습니다.

get과 fetch, create와 add처럼 뉘앙스가 다른 단어를 상황에 맞게 구분해서 쓰는 방식을 팀 내 컨벤션으로 정했습니다. 좋은 이름은 나중에 코드를 다시 보는 사람의 인지 비용을 줄여주는 가장 작은 단위의 문서라는 걸 배웠습니다.