Featured image of post [Clean Code] 05. 함수는 작게, 한 가지만

[Clean Code] 05. 함수는 작게, 한 가지만

함수를 작게 만들고 한 가지 일만 하도록 설계하는 원칙을 추상화 수준, 인수 개수, 부수 효과, 명령-조회 분리라는 네 가지 관점에서 다룬다. switch 문을 다형성으로 대체하는 방법과 과도한 분해의 한계도 함께 살펴본다.

Featured image of post [Clean Code] 06. 함수 리팩토링 실습

[Clean Code] 06. 함수 리팩토링 실습

80줄짜리 긴 주문 처리 함수를 파싱·검증·계산·저장 네 단계로 분해하는 실습을 통해 05장의 함수 설계 원칙을 직접 적용하고, 분해 전후의 테스트 용이성 차이와 분해를 어디서 멈춰야 하는지 판단 기준을 함께 살펴본다.

Featured image of post [Clean Code] 07. 주석은 실패를 의미한다

[Clean Code] 07. 주석은 실패를 의미한다

주석이 코드 표현력 부족을 감추는 임시방편일 수 있다는 관점에서 좋은 주석과 나쁜 주석을 구분하고, 주석 대신 코드로 의도를 표현하는 방법과 공개 API 문서화 도구의 역할을 실전 예제와 판단 기준으로 함께 다룬다.

Featured image of post [Clean Code] 08. 주석 걷어내기 실습

[Clean Code] 08. 주석 걷어내기 실습

중복 주석과 이력 기록 주석, 주석 처리된 죽은 코드로 뒤덮인 주문 서비스 코드를 07장의 기준에 따라 정리하며, 지운다·옮긴다·유지한다는 3단계 판단 절차를 실제 리뷰 상황처럼 적용해 어떤 주석을 남길지 직접 확인하는 실습이다.

Featured image of post [Clean Code] 09. 형식 맞추기와 코드 스타일

[Clean Code] 09. 형식 맞추기와 코드 스타일

코드 형식이 왜 미학이 아니라 의사소통의 일부인지 세로 밀집도·수직 거리·가로 정렬 원칙으로 설명하고, 개인 취향에 좌우되던 형식 논쟁을 자동 포매터와 팀 컨벤션으로 해소하는 방법을 우선순위 판단 기준과 함께 다룬다.

Featured image of post [Clean Code] 10. 포맷팅·린팅 자동화 실습

[Clean Code] 10. 포맷팅·린팅 자동화 실습

한 줄에 여러 문장이 압축된 사용자 관리 코드를 정리하고, Prettier·ESLint 같은 포매터·린터를 pre-commit 훅과 CI 파이프라인에 연결해 형식 논쟁을 팀 차원에서 자동으로 없애는 방법을 단계별로 실습한다.

Featured image of post [Clean Code] 11. 객체와 자료구조의 비대칭

[Clean Code] 11. 객체와 자료구조의 비대칭

객체는 동작을 노출하고 자료를 감추며, 자료구조는 자료를 노출하고 동작이 없다는 근본적 비대칭을 설명한다. 디미터 법칙, 기차 충돌 코드, DTO 설계 원칙을 실전 예제와 새 타입·새 연산 추가 트레이드오프 표로 다룬다.

Featured image of post [Clean Code] 12. 디미터 법칙 리팩토링 실습

[Clean Code] 12. 디미터 법칙 리팩토링 실습

정수 타입 코드로 도형 종류를 분기하는 절차적 계산기 코드를 다형성 객체로 변환하고, 여러 단계를 파고드는 기차 충돌 코드를 디미터 법칙에 따라 정리하는 두 가지 리팩토링 실습을 변경 시나리오 검증과 함께 진행한다.

Featured image of post [Clean Code] 13. 오류 코드 대신 예외를 써라

[Clean Code] 13. 오류 코드 대신 예외를 써라

오류 코드가 호출자 코드를 어떻게 오염시키는지 보이고, 예외에 의미 있는 컨텍스트를 담는 방법과 null 반환·전달을 피하는 기법을 다룬다. Optional·Result 타입 같은 현대적 오류 처리도 함께 비교한다.

Featured image of post [Clean Code] 14. 오류 처리 리팩토링 실습

[Clean Code] 14. 오류 처리 리팩토링 실습

정수 오류 코드로 뒤덮인 파일 처리 코드를 의미 있는 예외 계층과 Optional로 재설계하는 실습을 통해 13장에서 배운 오류 처리 원칙을 직접 적용하고, 예외 계층을 얼마나 세분화해야 하는지 실무 판단 기준으로 함께 검증한다.