- 유지보수하기 좋은 코드는 미래의 나를 포함한 누구나 쉽게 이해할 수 있는 코드이며, 이는 결국 가독성이 핵심이다. 📖
- 가독성의 핵심 원칙은 일관적인 스토리텔링이다. 코드는 버그 수정 및 이해를 위해 매끄러운 흐름을 유지하는 글이어야 한다. ✍️
- 함수는 단일 책임 원칙을 지켜 한 가지 기능만 수행해야 한다. 여러 관심사(계산, 파일 I/O, UI 등)가 섞이면 코드의 흐름이 깨지고 혼란을 야기한다. 🎯
- 예외 처리, 로깅, null 체크 같은 보조 로직은 메인 스토리 흐름을 방해하므로, 가드 절은 초반에, 예외/로깅은 경계 밖으로 밀어내거나 한곳에서 일관되게 처리해야 한다. 🚧
- 잘 쓰인 이야기처럼 같은 어휘, 문장 호흡, 장면 전환을 유지해야 독자가 쉽게 이해하고, 세부 구현을 잊었더라도 흐름을 따라가면 상기할 수 있다. 🎬
- 유지보수성 향상을 위해 포프의 코딩 표준 읽기, 일반 서적 읽기, 다른 사람의 잘 관리된 코드 읽기를 추천한다. 💡
데브허브 | DEVHUB | 유지보수하기 좋은 코드의 숨은 비밀