소프트웨어 설계 원칙Software Design Principles
모듈화 · 응집도 · 결합도 · SOLID 원칙처럼 «잘 나눈 설계»인지를 판단하는 원칙과 측정 기준을 묶은 것이다. 나눌 단위(시스템 · 모듈 · 클래스)마다 무엇을 감추고 무엇만 경계를 넘게 할지를 정한다.
1요약
- 소프트웨어 설계 원칙은 SWEBOK V4.0a 가 설계 지식 영역의 기초(3장 1.4절)로 두는 판정 기준으로, 그 위에서 정보 은닉에 따른 모듈화, 모듈 안 · 사이를 재는 응집도 · 결합도, 클래스 규칙인 SOLID 다섯 원칙이 돈다.
- 원칙 없이 나눈 설계는 기능 하나에 여러 파일이 함께 흔들린다 — 본문 사례에서 CSV 내보내기를 더할 때 고칠 기존 파일이 3개에서 0개(새 파일 1 · 조립 1줄)로 줄었다(설명용 가정 값).
- 「설계가 나쁘다」는 바뀌는 이유가 어디에 몰렸는가로 가른다 — 한 모듈에 이유가 여럿이면 응집 · 단일 책임 문제, 한 이유가 여러 모듈로 번지면 결합 · 의존 방향 문제, 구현을 바꿨더니 호출 쪽이 놀라면 치환 계약 문제다.
2등장 배경
1970년대 초 큰 프로그램은 처리 순서(입력 → 계산 → 출력)대로 나누는 것이 보통이었고, 자료 형식 하나를 바꾸면 그 형식을 읽는 모든 단계를 함께 고쳤다. Parnas 는 1972년 모듈을 «바뀔 가능성이 큰 설계 결정 하나를 감춘 단위»로 다시 정의했고(Parnas 1972), Stevens · Myers · Constantine 은 1974년 모듈 사이 연결의 세기(결합도)와 모듈 안 묶임의 세기(응집도)를 한 쌍의 척도로 냈다(Stevens 외 1974). 응집도 7단계는 1978년 교과서에서 정리됐다(Yourdon · Constantine 1978).
객체지향이 퍼지자 기준은 클래스 단위로 내려왔다. Meyer 는 1988년 «확장에는 열고 수정에는 닫는» 모듈을 말했고(Meyer 1988), Liskov · Wing 은 1994년 하위 형이 상위 형의 성질을 지켜야 한다는 행위 하위 형 정의를 냈다(Liskov · Wing 1994). Martin 이 2000년 이를 다섯 원칙으로 모았고(Martin 2000), 2009년 글에는 이미 SOLID 라는 이름이 붙어 있다(Martin 2009).
지금 SWEBOK V4.0a 는 설계 원칙을 설계 과정 · 품질 분석과 나란한 기초 주제로 두며, Martin 2020 은 다섯 원칙을 언어와 상관없는 모듈 · 인터페이스 말로 다시 썼다 — 원칙이 객체지향 문법이 아니라 변경 비용을 다루는 기준으로 남은 까닭이다.
3쉽게 이해하기 — 학교 축제 준비 위원회
서윤이는 학교 축제 준비 위원장이다. 일을 무대팀 · 먹거리팀 · 홍보팀으로 나누고, 팀끼리는 요청서 한 장으로만 부탁하게 했다. 둘째 날 음향을 맡던 학생이 아파 빠졌지만, 위원장은 「음향 담당 나와 주세요」라고 역할 이름으로만 불렀기 때문에 대신 나온 학생이 같은 일을 이어받았다. 사진팀을 새로 만들 때도 다른 팀의 규칙은 한 줄도 고치지 않았다.
그림 1 · 일을 팀으로 나누고(모듈화) 팀마다 한 목적만 두며(응집도) 팀끼리는 요청서 한 장만 오가게 하면(결합도), 새 팀을 더해도 다른 팀 규칙이 그대로다.
그림 2 · 위원장이 사람이 아니라 «음향 담당» 역할표에 기대면, 대신 나온 학생도 같은 약속을 지키는 한 아무도 고칠 것이 없다 — 실제 코드의 인터페이스와 구현이 같은 모양이다.
| 비유 속 역할 | 실제 이름 | 실제로 하는 일 |
|---|---|---|
| 팀 나누기 | 모듈화 · 정보 은닉 | 바뀔 결정 하나씩을 모듈 안에 감추고 경계를 정한다 |
| 무대 일만 하는 무대팀 | 응집도 · 단일 책임(SRP) | 같은 이유로 바뀌는 요소만 한 모듈에 모은다 |
| 요청서 한 장 | 결합도 | 경계를 넘는 것을 값 몇 개로 줄여 변경이 번지지 않게 한다 |
| 필요한 연락표만 받는 홍보팀 | 인터페이스 분리(ISP) | 쓰는 쪽마다 필요한 연산만 담은 작은 인터페이스를 준다 |
| 새로 만든 사진팀 | 개방 폐쇄(OCP) | 새 구현을 더하되 기존 모듈은 고치지 않는다 |
| 「음향 담당」 역할표 | 의존 역전(DIP) | 상위 정책이 구체 구현이 아닌 추상(인터페이스)에 기댄다 |
| 대신 나온 학생 B | 리스코프 치환(LSP) | 바꿔 끼운 구현도 같은 계약을 지켜 호출 쪽이 모르게 한다 |
⚠ 비유가 맞지 않는 곳: 축제 위원회는 사람이 알아서 빈틈을 메우지만, 코드에서는 인터페이스에 적히지 않은 약속(행 순서 · 예외 종류)을 아무도 지켜 주지 않는다. 그래서 치환 계약은 시험 코드로 적어 두어야 한다.
4구조 — 아래 토픽 지도
아래 토픽은 «무엇을 감출까 → 잘 나눴나 → 클래스끼리 어떻게 맞물릴까»의 순서로 단위가 작아진다.
| 토픽 | 묻는 질문 | 보는 단위 | 판정 · 척도 | 대표 근거 |
|---|---|---|---|---|
| 소프트웨어 설계 | 무엇을 어떤 절차로 나눌까 | 시스템 → 모듈 | 상위 설계 · 상세 설계 | SWEBOK V4.0a 3장 2절 |
| 모듈화 | 어떤 결정을 어디에 감출까 | 모듈 | 정보 은닉 · 변경 반경 | Parnas 1972 |
| 응집도 | 모듈 안이 한 목적인가 | 모듈 안 | 7단계(우연적 ~ 기능적) | Yourdon · Constantine 1978 |
| 결합도 | 경계를 넘는 것이 작고 단순한가 | 모듈 사이 | 6단계(자료 ~ 내용) | Stevens 외 1974 |
| SOLID 원칙 | 클래스 · 인터페이스를 어떻게 맞물릴까 | 클래스 · 인터페이스 | 다섯 원칙 | Martin 2000 · 2020 |
그림 3 · 설계 원칙은 나눌 단위가 작아지는 순서로 이어지고, 응집 · 결합 판정이나 SOLID 점검에서 걸린 곳은 다시 모듈 경계를 고치는 일로 돌아간다.
🔑 응집도 · 결합도는 «얼마나 잘 나눴나»를 재는 척도이고, SOLID 는 그 척도를 클래스 · 인터페이스 단위로 옮긴 규칙이다 — 척도가 같아서 원칙끼리 충돌하지 않고, 걸린 곳은 언제나 모듈 경계를 다시 긋는 일로 돌아간다.
5동작 — 성적표 서비스에 CSV 내보내기 더하기
성적표 서비스에 「CSV 로도 내보내기」 요구가 들어온 사례다. 클래스 이름 · 학생 30명 · 파일 수는 설명용 가정 값이고, 파일 수는 직접 센 값이다.
- 바뀔 결정을 적는다 — 등급 규칙 · 출력 형식 · 저장 위치 셋이 모두
ReportCard클래스 하나에 들어 있다(정보 은닉 기준 · Parnas 1972). - 바뀌는 이유를 센다 — 교무 규정 · 문서 형식 · 서버 설정 세 출처가 한 클래스를 바꾸므로 단일 책임 위반이다.
GradeCalculator·Exporter·ReportSaver로 나눈다. - 경계를 넘는 것을 본다 — 컨트롤러가
export("pdf")문자열로 분기를 골랐으므로 제어 결합이다. 형식 문자열 대신Exporter객체를 넘긴다. - 확장 지점을 만든다 —
Exporter.write(rows)를PdfExporter·CsvExporter가 구현한다. CSV 를 더할 때 기존 파일 수정 0 · 새 파일 1 · 조립 코드 1줄이다(Meyer 1988). - 치환 계약을 시험한다 — 「학생 30명이면 머리 1행 + 30행」 시험 하나를 두 구현에 똑같이 돌려 둘 다 통과시킨다(Liskov · Wing 1994).
- 인터페이스를 줄인다 — 저장 쪽 인터페이스의 메서드 4개(save · load · delete · archive) 중 내보내기는 save 하나만 쓰므로, 메서드 1개짜리
ReportSaver를 따로 둔다. - 의존 방향을 확인한다 —
GradeCalculator의 import 목록에는Exporter·ReportSaver두 인터페이스만 남고, 구체 클래스는 조립 코드만 안다(Martin 2020). - 변경 비용을 견준다 — 나누기 전에는 CSV 추가에 기존 파일 3개(컨트롤러 ·
ReportCard· 시험)를 고치고 세 클래스를 다시 시험했고, 나눈 뒤에는 새 파일 1개만 시험한다.
그림 4 · 나누기 전에는 형식 문자열이 컨트롤러에서 ReportCard 로 넘어가 CSV 추가가 기존 파일 셋을 흔들지만, 나눈 뒤에는 Exporter 뒤에 새 구현 하나만 붙는다.
그림 5 · SOLID 다섯 원칙은 정보 은닉에서 나온 두 척도 — 모듈 안을 좁히는 응집도와 경계 · 방향을 정하는 결합도 — 로 되돌아가며, 인터페이스 분리만 두 척도에 함께 걸린다.
🔑 SOLID 다섯 가운데 단일 책임만 모듈 «안»을 보고, 나머지 넷은 모두 모듈 «사이»의 경계 · 방향을 본다 — 그래서 원칙 위반을 찾을 때는 바뀌는 이유를 먼저 세고, 그다음 의존 화살을 본다.
6비교 — 관련 기술과의 경계
| 기술 | 맡는 일 | 설계 원칙과의 경계 | 넘기는 곳 |
|---|---|---|---|
| 소프트웨어 설계 원칙 | 모듈 · 클래스 경계가 좋은지 판정 | — | 경계를 넘는 구성 선택 → 소프트웨어 아키텍처 |
| 요구 공학 | 무엇을 만들지 · 품질 목표 | 「바뀔 가능성이 큰 결정」의 목록은 요구 변경 이력에서 온다 | 변경 빈도 · 우선순위 → 설계 원칙의 입력 |
| 소프트웨어 모델링 | 분석 · 설계를 UML 등으로 적음 | 모델은 경계를 «그리고», 원칙은 그 경계가 좋은지 «판정»한다 | 클래스도 · 의존도 → 판정 대상 |
| 소프트웨어 아키텍처 | 시스템 전체 구성 요소 · 연결 방식 | 같은 응집 · 결합 기준을 서비스 · 계층 분리 단위로 키워 쓴다 | 모듈 안 규칙 → 설계 원칙 |
| 분산 아키텍처 스타일 | 서비스 사이 통신 · 통합 방식 | 네트워크 너머의 결합(메시지 형식 · 동기 호출)은 그쪽이 맡는다 | 서비스 안 코드 구조 → 설계 원칙 |
| 코드 품질 관리(디자인 패턴 · Refactoring) | 되풀이 해법 · 구조 개선 절차 | 원칙은 «무엇이 좋은가», 패턴 · 리팩터링은 «어떻게 바꾸나» | 위반 판정 → 패턴 · 리팩터링 |
분석질문이 «이 경계가 좋은가»면 설계 원칙, «경계를 어떤 모양으로 놓나»면 아키텍처 · 패턴, «무엇을 감출지 근거가 없다»면 요구 공학으로 먼저 간다. 근거는 「넘기는 곳」 열 — 설계 원칙은 판정을 내고, 해법의 모양은 패턴 · 아키텍처가 고른다(SWEBOK V4.0a 3장 1.4 · 4.4절).
7실무 진단 — 변경 기록에서 원칙 위반 가르기
분석변경 기록 → 바뀌는 이유 → 의존 화살 순으로 본다. 커밋 하나가 건드린 파일 수는 원칙을 모르고도 바로 셀 수 있고, 이유 · 화살 분석은 그 수가 큰 곳에만 하면 된다(Martin 2020 · git-log --stat).
| # | 증상 | 의심 원인 | 원칙 | 확인 자료 | 판정 기준(근거) |
|---|---|---|---|---|---|
| 1 | 기능 하나 더할 때마다 기존 파일 여러 개 수정 | 확장 지점 없음 · 형식 분기 | 개방 폐쇄 · 결합도 | git log --stat 의 커밋별 파일 수 | 새 구현 추가가 기존 파일 수정 없이 되면 통과(Meyer 1988) |
| 2 | 한 클래스가 서로 다른 부서 요청으로 번갈아 바뀜 | 바뀌는 이유 둘 이상 | 단일 책임 · 응집도 | 커밋을 요청 출처별로 분류 | 출처가 하나면 통과(Martin 2020) |
| 3 | 구현을 바꾼 뒤 호출 쪽에 형 검사 분기가 생김 | 하위 형이 계약을 어김 | 리스코프 치환 | 같은 계약 시험을 모든 구현에 실행 | 모든 구현이 같은 시험 통과(Liskov · Wing 1994) |
| 4 | 쓰지 않는 메서드가 바뀌어도 재빌드 · 재배포 | 굵은 인터페이스 | 인터페이스 분리 | 호출하는 메서드 수 ÷ 인터페이스 메서드 수 | 쓰는 쪽마다 거의 전부 쓰면 통과(Martin 2020) |
| 5 | 상위 정책 시험에 DB · 네트워크가 필요 | 구체 클래스에 직접 기댐 | 의존 역전 | jdeps 의존 목록 · import 목록 | 상위 모듈이 인터페이스만 참조(Martin 2020) |
진단 뒤 깊은 판정은 아래 토픽이 맡는다 — 응집 단계 · 측정 값은 응집도, 결합 단계는 결합도, 감출 결정 목록은 모듈화로 내려간다.
8시험 대비
www.q-net.or.kr시험에서는 설계 원칙의 종류와 특징을 묻는 정의 · 특징형, 응집도 · 결합도와 SOLID 를 견주거나 원칙끼리 견주는 비교형이 나올 수 있다. 정의형이면 그림 3 지도로 원칙을 단위별로 세우고, 비교형이면 그림 5 처럼 SOLID 각 원칙이 어느 척도로 되돌아가는지 선으로 보인다.
- 개요 — 정의 · SWEBOK V4.0a 3장 1.4절 · 목적(변경 반경을 줄임)
- 지도 — 그림 3 단위별 흐름(설계 → 모듈화 → 응집 · 결합 → SOLID)과 아래 토픽 표
- 척도 — 응집도 7단계 · 결합도 6단계 이름 · 지향 방향(응집 ↑ · 결합 ↓)
- SOLID — 다섯 원칙 한 줄 정의(Martin 2020)와 그림 5 척도 대응
- 적용 사례 — 그림 4 CSV 내보내기(기존 파일 3 → 0 · 새 파일 1 · 계약 시험)
- 한계 · 판단 — 확장 지점은 실제로 바뀐 축에만 · 간접 호출 비용 · 진단 순서
꼭 쓸 키워드
정보 은닉모듈화응집도결합도단일 책임개방 폐쇄리스코프 치환인터페이스 분리의존 역전변경 반경
다른 답안과 차이를 내는 한 가지는 SOLID 를 다섯 줄로 나열하지 않고, 그림 5 처럼 넷은 결합 · 하나는 응집으로 되돌아간다는 관계로 묶어 쓰는 것이다.
9오해와 사실
- 오해SOLID 는 객체지향 언어에서만 쓰는 규칙이다.사실Martin 2020 은 다섯 원칙을 클래스가 아닌 «모듈 · 인터페이스 · 구현» 말로 다시 썼고, 단일 책임의 뿌리인 응집도는 객체지향 이전인 1974년 구조적 설계에서 나왔다(Stevens 외 1974).
- 오해원칙을 지키려면 처음부터 모든 클래스에 인터페이스를 둔다.사실Parnas 1972 의 출발점은 «바뀔 가능성이 큰 결정»의 목록이고, 확장 지점은 그 목록에 오른 축에만 둔다 — 사례의
Exporter도 출력 형식이 실제로 바뀐 뒤에 생겼다. - 오해정보 은닉과 캡슐화는 같은 말이다.사실캡슐화는 자료와 연산을 한 단위로 묶는 언어 장치이고, 정보 은닉은 그 단위가 무엇을 감출지 정하는 설계 기준이다 — private 필드만 있고 형식 결정이 인터페이스에 드러나면 은닉은 실패다(Parnas 1972).
10핵심 정리
| 원칙 | 보는 단위 | 묻는 질문 | 위반 신호 | 근거 |
|---|---|---|---|---|
| 정보 은닉 | 모듈 | 바뀔 결정이 모듈 안에 감춰졌나 | 형식 하나 바꾸는데 여러 모듈 수정 | Parnas 1972 |
| 응집도 | 모듈 안 | 요소가 한 목적으로 묶였나 | 기능 설명에 동사 둘 이상 | Yourdon · Constantine 1978 |
| 결합도 | 모듈 사이 | 넘는 것이 값 몇 개뿐인가 | 플래그 · 전역 자료 공유 | Stevens 외 1974 |
| 단일 책임(SRP) | 클래스 | 바뀌는 이유가 하나인가 | 여러 부서 요청이 한 클래스로 | Martin 2020 |
| 개방 폐쇄(OCP) | 모듈 · 클래스 | 고치지 않고 더할 수 있나 | 새 기능마다 기존 분기 수정 | Meyer 1988 |
| 리스코프 치환(LSP) | 하위 형 | 바꿔 끼워도 호출 쪽이 모르나 | 호출 쪽 형 검사 분기 | Liskov · Wing 1994 |
| 인터페이스 분리(ISP) | 인터페이스 | 쓰는 쪽이 필요한 것만 보나 | 안 쓰는 메서드 변경에 재빌드 | Martin 2020 |
| 의존 역전(DIP) | 의존 화살 | 상위 정책이 추상에 기대나 | 정책 시험에 DB · 네트워크 필요 | Martin 2000 · 2020 |
11참고 문헌
- 먼저 볼 문헌
- ★ SWEBOK Guide V4.0a Topics — Chapter 3 Software Design (1.4 Software Design Principles) — 설계 원칙이 설계 지식 영역 안에서 어디에 놓이는지 볼 때
- ★ On the Criteria To Be Used in Decomposing Systems into Modules · Communications of the ACM 15(12) pp.1053-1058 — 모듈을 «감춘 설계 결정»으로 정의한 원문을 볼 때
- ★ Structured design · IBM Systems Journal 13(2) pp.115-139 — 결합도 · 응집도를 처음 한 쌍의 척도로 낸 논문을 볼 때
- ★ Solid Relevance (The Clean Code Blog) — SOLID 다섯 원칙을 모듈 · 인터페이스 말로 한 줄씩 다시 쓴 것을 볼 때
- 본문 근거
- Structured Design - Fundamentals of a Discipline of Computer Program and Systems Design (Second Edition) — Edward Yourdon · Larry L. Constantine (Yourdon Press) · 1978-01 · 확인 2026-11-14
- Object-Oriented Software Construction — Bertrand Meyer (Prentice Hall) · 1988-01 · 확인 2026-11-14
- A Behavioral Notion of Subtyping · ACM Transactions on Programming Languages and Systems 16(6) pp.1811-1841 — B. H. Liskov · J. M. Wing · 1994-11 ·
doi.org/10.1145/197320.197383· 확인 2026-11-14 - Design Principles and Design Patterns — Robert C. Martin (Object Mentor) · 2000-01 · 확인 2026-11-14
- Getting a SOLID start — Robert C. Martin (Uncle Bob Consulting) · 2009-02 ·
sites.google.com/site/unclebobconsultingllc/getting-a-solid-start· 확인 2026-11-14 - git-log Documentation — Git Project · 2026-11 ·
git-scm.com/docs/git-log· 확인 2026-11-14 - jdeps - Java class dependency analyzer (Java SE 21 Tool Specifications) — Oracle · 2026-11 ·
docs.oracle.com/en/java/javase/21/docs/specs/man/jdeps.html· 확인 2026-11-14