https://philipjkim.cc/tags/convention/Recent content in Convention on philipjkimHugoen-USTue, 26 Aug 2025 19:34:33 +0900https://philipjkim.cc/posts/20250826-go-package-conventions/Tue, 26 Aug 2025 19:34:33 +0900https://philipjkim.cc/posts/20250826-go-package-conventions/<p>Go 언어 프로젝트의 패키지 구조는 일반적으로 몇 가지 컨벤션을 따르며, <code>pkg</code>와 <code>internal</code> 디렉토리는 그중 핵심적인 역할을 합니다. 단순히 코드를 기능별로 묶는 것을 넘어, 패키지의 <strong>가시성(visibility)과 의존성 방향을 명확히</strong> 하여 프로젝트의 유지보수성을 높이는 것이 목적입니다.</p> <p><em>이 글은 Gemini 2.5 Pro 모델이 제 Go package convention 에 대한 질문에 답변한 내용입니다.</em></p> <hr> <p>Go 커뮤니티에서 널리 통용되는 표준 프로젝트 레이아웃(<a href="https://github.com/golang-standards/project-layout">golang-standards/project-layout</a>)을 기반으로 각 디렉토리의 역할과 베스트 프랙티스를 자세히 설명해 드리겠습니다.</p> <h2 id="-pkg-디렉토리-공개-라이브러리-public-library">📦 <code>pkg</code> 디렉토리: 공개 라이브러리 (Public Library)</h2> <p><strong><code>pkg</code> 디렉토리</strong>에는 <strong>외부 프로젝트에서 가져다 쓸 수 있는(importable) 공개 라이브러리 성격의 코드</strong>를 위치시킵니다.</p>