Community

개발자 99% 커뮤니티에서 수다 떨어요!

← Go back
[TIL] 2장 의미있는 이름
#clean_code
2년 전
955

오늘 TIL 3줄 요약

  • 함수의 이름은 의도가 분명해야한다. 말은 쉽지만 작성자가 아닌 다른 사람이 봤을 때 한 눈에 의도를 파악할 수 있도록 심사숙고 해야 한다.

  • 불필요한 내용들은 제거하라. 필요한 내용들만 있어야 가장 손쉽게 내용을 파악하고 더 나은 이름을 지을 수 있다.

  • 좋은 이름을 위해서 여러가지 이름들을 시도해보고 가장 의미 전달이 뛰어난 이름을 사용하자.

TIL (Today I Learned) 날짜

2022.04.24

오늘 읽은 범위

2장. 의미있는 이름

책에서 기억하고 싶은 내용을 써보세요.

  • 책에서 의도를 분명하게 밝히라고 한다. 이 문구가 가장 공감 됐는데 가끔 특정 함수들은 분명하게 짓기가 어려운 경우가 있었다. 결국 역할과 책임을 제대로 분리하지 못했기에 생긴 문제라고 생각된다.

  • 불용어의 경우는 흔히 사용하는 실수인 것 같다. updateSendData 같은 경우보다는 metricizeOnSendEvent 같은 이름으로 불용어를 최대한 줄이는 방향으로 계속해서 고민이 필요할 것 같다.
    (물론 metricize 같은 용어도 잘 쓰이는 용어가 아니라서 바꾸고 싶다. updateDynamoDbOnSendEvent 같은?)

  • 한 개념에 한 단어!
    회사에서도 잘 사용중인데
    예를 들어, fetch와 find는 값이 반드시 있는 경우와 없을 수 있는 경우같은 차이와 같은 뉘앙스를 가지고 있다. 정립해둔 개념을 혼동하지말고 잘 사용하자

오늘 읽은 소감은? 떠오르는 생각을 가볍게 적어보세요

  • 좋은 이름 다시 생각해도 너무 어렵다. 어떤 함수를 다른 사람들과 얘기하면서 어떻게 바꿀지 결정해보려고 했는데도 잘 결정이 나지 않는 경우도 꽤 있었다. 계속해서 하나씩 바꿔보고 또 클린코드를 계속 읽으면서 꾸준히 좋은 이름에 대해서 고민이 필요할 것 같다.


궁금한 내용이 있거나, 잘 이해되지 않는 내용이 있다면 적어보세요.

오늘 읽은 다른사람의 TIL