<div id="readability-page-1" class="page"><article id="post-web-gradle-settings-vs-build" class="page" role="article"><header><p><span> <time datetime="2025-07-13T00:00:00+00:00">13 Jul 2025</time> in <a href="/web/">Web</a> </span></p><p> 스프링 부트를 멀티모듈로 개발하다보면 <code>settings.gradle</code>과 <code>build.gradle</code>의 책임이 헷갈릴 때가 있다. 필자는 이 글에서 둘의 역할과 차이점을 명확히 정리해보고자 한다.</p></header><hr><ul id="markdown-toc"><li><a href="#-settingsgradle의-역할" id="markdown-toc--settingsgradle의-역할">📌 Settings.gradle의 역할</a><ul><li><a href="#주요-기능" id="markdown-toc-주요-기능">주요 기능</a></li><li><a href="#빌드-실행-시" id="markdown-toc-빌드-실행-시">빌드 실행 시</a></li></ul></li><li><a href="#-buildgradle의-역할" id="markdown-toc--buildgradle의-역할">📌 build.gradle의 역할</a></li><li><a href="#-settingsgradle-vs-buildgradle-차이" id="markdown-toc--settingsgradle-vs-buildgradle-차이">🔍 settings.gradle vs build.gradle 차이</a></li><li><a href="#-멀티모듈-빌드-흐름" id="markdown-toc--멀티모듈-빌드-흐름">🔍 멀티모듈 빌드 흐름</a></li><li><a href="#-마치며" id="markdown-toc--마치며">📝 마치며</a></li></ul><h2 id="-settingsgradle의-역할">📌 Settings.gradle의 역할</h2><p><code>settings.gralde</code>은 Gradle이 프로젝트 전체를 어떻게 구성할지를 정의하는 곳이다. 즉 루트 프로젝트와 서브 프로젝트(모듈)를 등록하고, 멀티모듈 빌드를 위한 스캐폴딩을 제공한다.</p><h3 id="주요-기능">주요 기능</h3><ul><li>프로젝트 이름 정의</li><li>어떤 모듈(프로젝트)을 포함할지 결정</li></ul><div><pre><code><span>rootProject</span><span>.</span><span>name</span> <span>=</span> <span>"my-app"</span>
<span>include</span><span>(</span><span>"core"</span><span>,</span> <span>"service"</span><span>,</span> <span>"web"</span><span>)</span>
</code></pre></div><h3 id="빌드-실행-시">빌드 실행 시</h3><ul><li><code>gradle build</code>를 하면 Gradle은 먼저 <code>settings.gradle</code>읅고,</li><li><code>core</code>, <code>service</code>, <code>web</code> 모듈을 찾아서 빌드 그래프를 생성한다.</li></ul><h2 id="-buildgradle의-역할">📌 build.gradle의 역할</h2><p><code>build.gradle</code>은 각 모듈(또는 루트)에 대한 <strong>빌드 스크립트</strong>이다.</p><ul><li>의존성, 플러그인, 빌드 태스크를 정의한다.</li></ul><p>보통 멀티모듈에서는</p><ul><li>루트 <code>build.gradle</code>에 공통 설정을,</li><li>각 모듈(<code>core/build.gradle</code> 등)에 모듈별 의존성을 작성한다.</li></ul><div><pre><code><span>plugins</span> <span>{</span>
    <span>id</span> <span>'java'</span>
<span>}</span>

<span>dependencies</span> <span>{</span>
    <span>implementation</span> <span>'org.springframework.boot:spring-boot-starter-web'</span>
<span>}</span>
</code></pre></div><h2 id="-settingsgradle-vs-buildgradle-차이">🔍 settings.gradle vs build.gradle 차이</h2><table><thead><tr><th>항목</th><th>settings.gradle</th><th>build.gradle</th></tr></thead><tbody><tr><td><strong>책임</strong></td><td>프로젝트 계층(루트 &amp; 서브 프로젝트) 관리</td><td>빌드 로직, 의존성, 플러그인 설정</td></tr><tr><td><strong>실행 시점</strong></td><td>Gradle이 빌드 DAG 구성할 때 최초 실행</td><td>각 프로젝트 빌드 시 실행</td></tr><tr><td><strong>멀티모듈</strong></td><td>어떤 모듈을 포함할지 <code>include</code></td><td>그 모듈을 어떻게 빌드할지 정의</td></tr><tr><td><strong>DSL</strong></td><td><code>rootProject</code>, <code>include</code> 등</td><td><code>plugins</code>, <code>dependencies</code>, <code>tasks</code> 등</td></tr></tbody></table><h2 id="-멀티모듈-빌드-흐름">🔍 멀티모듈 빌드 흐름</h2><ol><li><code>gradle build</code> 실행</li><li>Gradle은 <code>settings.gradle</code>을 읽어 <strong>빌드 그래프(DAG)</strong> 를 만든다.</li><li>각 모듈에 들어가 <code>build.gradle</code>을 읽어 빌드, 테스트, 패키징을 수행한다.</li></ol><hr><h2 id="-마치며">📝 마치며</h2><p>정리하자면,</p><ul><li><code>settings.gradle</code>은 <strong>프로젝트 구조를 잡는 설계도</strong></li><li><code>build.gradle</code>은 <strong>빌드 작업을 수행하는 시방서</strong></li></ul><p>멀티모듈을 설계할 때 이 둘의 역할을 정확히 이해하면 코드 구조, 빌드 관리, CI/CD 설계까지 훨씬 깔끔해진다.</p><p>다음에는 <code>api</code> vs <code>implementation</code> 같은 의존성 스코프도 다뤄보고자 한다.</p></article><div role="contentinfo"><hr><p><small>© 2021. All rights reserved. </small></p><nav><small> <a href="/LICENSE/">LICENSE</a> | <a href="/NOTICE/">NOTICE</a> | <a href="/CHANGELOG/">CHANGELOG</a> </small></nav><p><small>Powered by <a href="https://hydejack.com/">Hydejack</a> v<span id="_version">9.2.1</span></small></p><hr></div></div>

개발자 이진우

Jinwoo Lee

📌 Settings.gradle의 역할    
주요 기능
빌드 실행 시
📌 build.gradle의 역할
🔍 settings.gradle vs build.gradle 차이
🔍 멀티모듈 빌드 흐름
📝 마치며
📌 Settings.gradle의 역할
settings.gralde은 Gradle이 프로젝트 전체를 어떻게 구성할지를 정의하는 곳이다. 즉 루트 프로젝트와 서브 프로젝트(모듈)를 등록하고, 멀티모듈 빌드를 위한 스캐폴딩을 제공한다.
주요 기능
프로젝트 이름 정의
어떤 모듈(프로젝트)을 포함할지 결정
rootProject.name = "my-app"
include("core", "service", "web")
빌드 실행 시
gradle build를 하면 Gradle은 먼저 settings.gradle읅고,
core, service, web 모듈을 찾아서 빌드 그래프를 생성한다.
📌 build.gradle의 역할
build.gradle은 각 모듈(또는 루트)에 대한 빌드 스크립트이다.
의존성, 플러그인, 빌드 태스크를 정의한다.
보통 멀티모듈에서는
루트 build.gradle에 공통 설정을,
각 모듈(core/build.gradle 등)에 모듈별 의존성을 작성한다.
plugins {
    id 'java'
}
dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
}
🔍 settings.gradle vs build.gradle 차이
항목
      settings.gradle
      build.gradle
    
책임
      프로젝트 계층(루트 & 서브 프로젝트) 관리
      빌드 로직, 의존성, 플러그인 설정
    
실행 시점
      Gradle이 빌드 DAG 구성할 때 최초 실행
      각 프로젝트 빌드 시 실행
    
멀티모듈
      어떤 모듈을 포함할지 include
      그 모듈을 어떻게 빌드할지 정의
    
DSL
      rootProject, include 등
      plugins, dependencies, tasks 등
    
🔍 멀티모듈 빌드 흐름
gradle build 실행
Gradle은 settings.gradle을 읽어 빌드 그래프(DAG) 를 만든다.
각 모듈에 들어가 build.gradle을 읽어 빌드, 테스트, 패키징을 수행한다.
📝 마치며
정리하자면,
settings.gradle은 프로젝트 구조를 잡는 설계도
build.gradle은 빌드 작업을 수행하는 시방서
멀티모듈을 설계할 때 이 둘의 역할을 정확히 이해하면 코드 구조, 빌드 관리, CI/CD 설계까지 훨씬 깔끔해진다.
다음에는 api vs implementation 같은 의존성 스코프도 다뤄보고자 한다.

Gradle에서 settings.gradle과 build.gradle의 역할과 차이

댓글