Community

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

← Go back
TIL Assignment #3 2장. 의미 있는 이름
#clean_code
2년 전
1,029

오늘 TIL 3줄 요약

  • 재미난 이름보다 명료한 이름을 선택하라.

  • 한 단어를 두 가지 목적으로 사용하지 마라

  • 일반적으로는 짧은 이름이 긴 이름보다 좋다. 단, 의미가 분명한 경우에 한해 서다.

TIL (Today I Learned) 날짜

2022.4.25

오늘 읽은 범위

2장. 의미 있는 이름

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

  • 문제는 코드의 단순성이 아니라 코드의 함축성이다. 다시 말해, 코드 맥락이 코드 자체에 명시적으로 드러나지 않는다. (p.23)

  • 프로그래머는 코드에 그릇된 단서를 남겨서는 안 된다. (p.24)

  • 서로 흡사한 이름을 사용하지 않도록 주의한다. (p.24)

  • 이름으로 그릇된 정보를 제공하는 진짜 끔찍한 예가 소문자 L이나 대문자 O 변수다. (p.24)

  • 읽는 사람이 차이를 알도록 이름을 지어라.(p.27)

  • 긴 이름이 짧은 이름보다 좋다. 검색하 기 쉬운 이름이 상수보다 좋다.(p.28)

  • 이름 길이 는 범위 크기에 비례해야 한다. (p.28)

  • 문제 해결에 집중하는 개발자에게 인코딩은 불필요한 정신적 부 담이다. 인코딩한 이름은 거의가 발음하기 어려우며 오타가 생기기도 쉽다. (p.29)

  • 독자가 코드를 읽으면서 변수 이름을 자신이 아는 이름으로 변환해야 한다면 그 변수 이름은 바람직하지 못하다. (p.31)

  • 루프에서 반복 횟수 변수는 전통적으로 한 글자를 사용하기 때문이다. (p.31)

  • 전문가 프로그래머는 자신의 능력을 좋은 방향으로 사용해 남들이 이해하는 코드를 내놓는다. (p.31-32)

  • 재미난 이름보다 명료한 이름을 선택하라. (p.32)

  • 특정 문화에 서만 사용하는 농담은 피하는 편이 좋다.(p.33)

  • 일관성 있는 어휘는 코드를 사용할 프로그래머가 반갑게 여길 선물이다.(p.33)

  • 한 단어를 두 가지 목적으로 사용하지 마라.(p.34)

  • 프로그래머는 코드를 최대한 이해하기 쉽게 짜야 한다.(p.34)

  • 전산 용어, 알 고리즘 이름, 패턴 이름, 수학 용어 등을 사용해도 괜찮다.(p.34)

  • 적절한 ‘프로그래머 용어’가 없다면 문제 영역에서 이름을 가져온다.(p.34)

  • 일반적으로는 짧은 이름이 긴 이름보다 좋다. 단, 의미가 분명한 경우에 한해 서다. 이름에 불필요한 맥락을 추가하지 않도록 주의한다 (p.37)

  • 좋은 이름을 선택하려면 설명 능력이 뛰어나야 하고 문화적인 배경이 같아야 한다. 이것이 제일 어렵다.(p.38)

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

이름이 중요하다는 것을 알고 있었지만, 내가 아닌 다른 프로그래머도 명확하게 읽을 수 있는지에 대한 생각이 여태까지 부족하다는 것을 깨달았다. 또한 짧은 이름이 좋다고만 생각했지만 그렇게 간단한 문제가 아니라는 것을 또한 생각하게 되었다. 무엇보다 중요한 것은 이름의 명확성인거 같다.

가장 와닿은 부분은 자신이 짠 클래스 이름과 메서드 이름을 모두 암기하지 못한다는 사실이다.

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

  • 스스로 의미가 분명한 이름이 없지 않다. 하지만 대다수 이름은 그렇지 못하다...

    그럼 영어가 모국어가 아닌 프로그래머들은 접두어를 많이 사용하는가? 

오늘 읽은 다른사람의 TIL

https://nomadcoders.co/community/thread/4518