설치

환경 요구사항

요구사항	버전
Go	≥ 1.25
운영체제	Linux / macOS / Windows

팁 Go 버전 안내

DD 는 Go 1.25 의 일부 기능을 사용합니다. 프로젝트에서 이전 버전의 Go 를 사용 중이라면 도구체인을 업그레이드하세요: go env -w GOTOOLCHAIN=go1.25.0+auto.

빠른 설치

go get github.com/cybergodev/dd

Go Module 통합

프로젝트 루트 디렉터리에서 실행:

# 모듈 초기화 (아직 go.mod 가 없는 경우)
go mod init your-project

# DD 의존성 추가
go get github.com/cybergodev/dd

패키지 임포트:

import "github.com/cybergodev/dd"

설치 확인:

package main

import "github.com/cybergodev/dd"

func main() {
    dd.Info("DD 설치 성공!")
}

버전 관리

버전 지정

# 특정 버전 설치
go get github.com/cybergodev/[email protected]

# 최신 버전으로 업그레이드
go get github.com/cybergodev/dd@latest

의존성 관리

# 의존성 정리 (사용하지 않는 의존성 제거, 누락된 의존성 추가)
go mod tidy

# 현재 의존성 버전 확인
go list -m github.com/cybergodev/dd

CI/CD 통합

GitHub Actions 에서 DD 사용:

steps:
  - uses: actions/setup-go@v5
    with:
      go-version: '1.25'
  - uses: actions/checkout@v4
  - run: go mod download
  - run: go build ./...

경고 프라이빗 저장소

DD 가 프라이빗 Git 서버에 호스팅된 경우 GOPRIVATE 환경 변수를 설정하세요:

go env -w GOPRIVATE=github.com/cybergodev/*

자주 묻는 질문

go get 실행 시 module not found 오류

Go 버전이 ≥ 1.25 인지 확인하고 네트워크 프록시 설정을 점검하세요:

go env -w GOPROXY=https://proxy.golang.org,direct

컴파일 시 undefined: dd.xxx 오류

go mod tidy 를 실행하여 의존성을 동기화한 후 다시 빌드하세요.

다음 단계

• 빠른 시작 -- 5 분 입문 가이드
• 글로벌 Logger -- 패키지 수준 편의 함수 사용 패턴
• 핵심 개념 -- DD 아키텍처 이해