Go 가이드 | AI DevOps Korea

목차 11개 섹션

가이드 사용법
구조 다이어그램
환경 설정
기본 문법
에러 처리
인터페이스
Goroutine & Channel
HTTP 서버
Go 설계
운영 기준
검증 전략

가이드 사용법

읽는 방향

Go를 실무 흐름으로 이해하기

Google이 만든 Go 언어를 학습합니다. 빠른 컴파일, 명시적 에러 처리, 인터페이스, goroutine 기반 동시성, 강력한 표준 라이브러리로 고성능 서버와 CLI 도구를 만드세요. 이 가이드는 개념을 나열하기보다, 실제 프로젝트에서 판단해야 하는 순서대로 내용을 따라갈 수 있게 구성했습니다.

핵심 관점

백엔드 / 시스템 개발

문법보다 요청이 들어와 검증, 처리, 저장, 응답으로 이어지는 경계를 먼저 잡습니다.

고성능 API 서버CLI 도구마이크로서비스DevOps 도구 (Docker, K8s)

구조 다이어그램

글로 읽은 내용을 머릿속에 오래 남기려면 먼저 흐름을 그림으로 잡는 편이 좋습니다. 아래 두 그림은 Go를 학습할 때 계속 되돌아볼 수 있는 기준 지도입니다.

학습 흐름

다이어그램 렌더링 중…

아키텍처 관점

다이어그램 렌더링 중…

환경 설정

Go를 처음 펼칠 때는 세부 명령보다 큰 그림이 먼저입니다. 이 섹션에서는 앞으로 배울 개념들이 어떤 문제를 풀기 위해 등장했는지부터 잡아봅니다.

Go는 컴파일러 하나로 빌드·테스트·의존성 관리까지 처리하는 단일 도구 체인을 제공합니다. go mod init으로 모듈을 초기화하면 그 순간부터 의존성 버전이 go.mod/go.sum에 고정됩니다.

BASH

# macOS
brew install go
go version

# 새 모듈 생성
mkdir myapp && cd myapp
go mod init github.com/username/myapp

기본 문법

여기서는 기본 문법을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.

Go의 특징은 정적 타입, 간결한 문법, 그리고 예외(exception) 대신 명시적인 에러 반환값입니다. 함수가 실패할 수 있으면 관례적으로 마지막 반환값으로 error를 함께 돌려주고, 호출하는 쪽은 매번 그 값을 확인합니다.

main.goGO

package main

import "fmt"

func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, fmt.Errorf("division by zero")
    }
    return a / b, nil
}

func main() {
    result, err := divide(10, 3)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    fmt.Printf("Result: %.2f\n", result)
}

에러 처리

여기서는 에러 처리을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.

Go에는 try-catch가 없습니다. 대신 모든 실패 가능 지점에서 error를 반환하고 `if err != nil`로 즉시 확인하는 것이 관례입니다. 에러를 감쌀 때는 `%w`로 원본 에러를 보존하면, 나중에 `errors.Is`/`errors.As`로 원인을 추적할 수 있습니다.

errors.goGO

import (
    "errors"
    "fmt"
)

var ErrNotFound = errors.New("user not found")

func findUser(id int) (*User, error) {
    user, ok := db[id]
    if !ok {
        return nil, fmt.Errorf("findUser(%d): %w", id, ErrNotFound)  // %w로 원본 에러 보존
    }
    return user, nil
}

func main() {
    _, err := findUser(42)
    if errors.Is(err, ErrNotFound) {   // 감싸진 에러 체인 안에서도 원본 에러 타입을 판별
        fmt.Println("사용자를 찾을 수 없습니다")
    }
}

인터페이스

여기서는 인터페이스을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.

Go의 인터페이스는 Java처럼 `implements`를 명시하지 않습니다. 어떤 타입이 인터페이스가 요구하는 메서드를 전부 가지고 있으면 자동으로 그 인터페이스를 만족합니다(구조적 타이핑). 덕분에 나중에 정의한 인터페이스에도 기존 타입을 아무 수정 없이 끼워 맞출 수 있습니다.

interfaces.goGO

type Writer interface {
    Write(data string) error
}

type ConsoleWriter struct{}
func (ConsoleWriter) Write(data string) error {
    fmt.Println(data)
    return nil
}

type FileWriter struct{ path string }
func (f FileWriter) Write(data string) error {
    return os.WriteFile(f.path, []byte(data), 0644)
}

// ConsoleWriter, FileWriter 둘 다 별도 선언 없이 Writer를 만족함
func log(w Writer, msg string) {
    w.Write(msg)
}

func main() {
    log(ConsoleWriter{}, "hello")
    log(FileWriter{path: "log.txt"}, "hello")
}

Goroutine & Channel

여기서는 Goroutine & Channel을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.

Go의 goroutine은 OS 스레드보다 훨씬 가벼운 동시성 단위입니다. 수백만 개를 동시에 실행할 수 있습니다. Channel은 goroutine 사이에 값을 안전하게 주고받는 통로로, "메모리를 공유해서 통신하지 말고, 통신으로 메모리를 공유하라"는 Go의 동시성 철학을 코드로 구현한 것입니다.

다이어그램 렌더링 중…

func worker(id int, jobs <-chan int, results chan<- int) {
    for j := range jobs {
        results <- j * j
    }
}

func main() {
    jobs    := make(chan int, 100)
    results := make(chan int, 100)

    for w := 0; w < 5; w++ {
        go worker(w, jobs, results)
    }
    for j := 0; j < 9; j++ { jobs <- j }
    close(jobs)
    for r := 0; r < 9; r++ { fmt.Println(<-results) }
}

HTTP 서버

여기서는 HTTP 서버을 실제 코드와 함께 확인합니다. 예제를 그대로 따라 하기보다, 입력과 출력, 그리고 바뀌기 쉬운 부분이 어디인지 보면서 읽어보세요.

표준 라이브러리 net/http만으로도 별도 프레임워크 없이 실용적인 REST API 서버를 만들 수 있습니다. Go 1.22부터는 라우팅 패턴에 HTTP 메서드(GET, POST 등)를 직접 명시할 수 있어 별도 라우터 없이도 메서드별 분기가 가능합니다.

package main

import (
    "encoding/json"
    "net/http"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

func main() {
    http.HandleFunc("GET /users", func(w http.ResponseWriter, r *http.Request) {
        users := []User{{1, "Alice"}, {2, "Bob"}}
        w.Header().Set("Content-Type", "application/json")
        json.NewEncoder(w).Encode(users)
    })
    http.ListenAndServe(":8080", nil)
}

Go 실무 설계

Go 실무 설계은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.

Go는 작은 interface와 explicit dependency가 강점입니다. handler, service, repository, client를 단순하게 분리하고 context.Context를 경계마다 전달해야 합니다.

결정 지점	확인 질문	실무 기준
경계	Go 코드에서 바뀌기 쉬운 부분은 어디인가?	입출력, 설정, 외부 연동, 핵심 규칙을 분리합니다.
상태	상태가 어디서 생성되고 어디서 사라지는가?	상태 소유자와 수명 주기를 코드로 드러냅니다.
장애	실패했을 때 호출자는 무엇을 받는가?	timeout, fallback, error contract를 먼저 정합니다.

Go 운영 기준

이 섹션은 Go 운영 기준을 실무 관점에서 정리합니다. 개념을 외우기보다, 어떤 상황에서 이 기준을 꺼내 쓸지에 초점을 맞춰보세요.

goroutine leak, context timeout, connection pool, pprof, graceful shutdown을 운영 기준으로 봅니다.

Go 검증 전략

Go 검증 전략은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.

table-driven test, race detector, benchmark, httptest를 기본 품질 도구로 사용해야 합니다.

품질 축	검증 방법	완료 기준
정확성	정상/실패 케이스를 자동화합니다.	핵심 시나리오가 재현 가능하게 통과합니다.
회귀 방지	버그 수정 시 동일 케이스를 테스트로 남깁니다.	같은 장애가 다시 배포되지 않습니다.
운영성	로그, 메트릭, 알림을 확인합니다.	문제가 생겼을 때 원인 추적 경로가 있습니다.

목차 11개 섹션

가이드 사용법
구조 다이어그램
환경 설정
기본 문법
에러 처리
인터페이스
Goroutine & Channel
HTTP 서버
Go 설계
운영 기준
검증 전략

가이드 사용법

읽는 방향

Go를 실무 흐름으로 이해하기

핵심 관점

백엔드 / 시스템 개발

문법보다 요청이 들어와 검증, 처리, 저장, 응답으로 이어지는 경계를 먼저 잡습니다.

고성능 API 서버CLI 도구마이크로서비스DevOps 도구 (Docker, K8s)

구조 다이어그램

학습 흐름

다이어그램 렌더링 중…

아키텍처 관점

다이어그램 렌더링 중…

환경 설정

Go를 처음 펼칠 때는 세부 명령보다 큰 그림이 먼저입니다. 이 섹션에서는 앞으로 배울 개념들이 어떤 문제를 풀기 위해 등장했는지부터 잡아봅니다.

BASH

# macOS
brew install go
go version

# 새 모듈 생성
mkdir myapp && cd myapp
go mod init github.com/username/myapp

기본 문법

main.goGO

package main

import "fmt"

func divide(a, b float64) (float64, error) {
    if b == 0 {
        return 0, fmt.Errorf("division by zero")
    }
    return a / b, nil
}

func main() {
    result, err := divide(10, 3)
    if err != nil {
        fmt.Println("Error:", err)
        return
    }
    fmt.Printf("Result: %.2f\n", result)
}

에러 처리

errors.goGO

import (
    "errors"
    "fmt"
)

var ErrNotFound = errors.New("user not found")

func findUser(id int) (*User, error) {
    user, ok := db[id]
    if !ok {
        return nil, fmt.Errorf("findUser(%d): %w", id, ErrNotFound)  // %w로 원본 에러 보존
    }
    return user, nil
}

func main() {
    _, err := findUser(42)
    if errors.Is(err, ErrNotFound) {   // 감싸진 에러 체인 안에서도 원본 에러 타입을 판별
        fmt.Println("사용자를 찾을 수 없습니다")
    }
}

인터페이스

interfaces.goGO

type Writer interface {
    Write(data string) error
}

type ConsoleWriter struct{}
func (ConsoleWriter) Write(data string) error {
    fmt.Println(data)
    return nil
}

type FileWriter struct{ path string }
func (f FileWriter) Write(data string) error {
    return os.WriteFile(f.path, []byte(data), 0644)
}

// ConsoleWriter, FileWriter 둘 다 별도 선언 없이 Writer를 만족함
func log(w Writer, msg string) {
    w.Write(msg)
}

func main() {
    log(ConsoleWriter{}, "hello")
    log(FileWriter{path: "log.txt"}, "hello")
}

Goroutine & Channel

다이어그램 렌더링 중…

func worker(id int, jobs <-chan int, results chan<- int) {
    for j := range jobs {
        results <- j * j
    }
}

func main() {
    jobs    := make(chan int, 100)
    results := make(chan int, 100)

    for w := 0; w < 5; w++ {
        go worker(w, jobs, results)
    }
    for j := 0; j < 9; j++ { jobs <- j }
    close(jobs)
    for r := 0; r < 9; r++ { fmt.Println(<-results) }
}

HTTP 서버

package main

import (
    "encoding/json"
    "net/http"
)

type User struct {
    ID   int    `json:"id"`
    Name string `json:"name"`
}

func main() {
    http.HandleFunc("GET /users", func(w http.ResponseWriter, r *http.Request) {
        users := []User{{1, "Alice"}, {2, "Bob"}}
        w.Header().Set("Content-Type", "application/json")
        json.NewEncoder(w).Encode(users)
    })
    http.ListenAndServe(":8080", nil)
}

Go 실무 설계

Go 실무 설계은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.

Go는 작은 interface와 explicit dependency가 강점입니다. handler, service, repository, client를 단순하게 분리하고 context.Context를 경계마다 전달해야 합니다.

결정 지점	확인 질문	실무 기준
경계	Go 코드에서 바뀌기 쉬운 부분은 어디인가?	입출력, 설정, 외부 연동, 핵심 규칙을 분리합니다.
상태	상태가 어디서 생성되고 어디서 사라지는가?	상태 소유자와 수명 주기를 코드로 드러냅니다.
장애	실패했을 때 호출자는 무엇을 받는가?	timeout, fallback, error contract를 먼저 정합니다.

Go 운영 기준

이 섹션은 Go 운영 기준을 실무 관점에서 정리합니다. 개념을 외우기보다, 어떤 상황에서 이 기준을 꺼내 쓸지에 초점을 맞춰보세요.

goroutine leak, context timeout, connection pool, pprof, graceful shutdown을 운영 기준으로 봅니다.

Go 검증 전략

Go 검증 전략은 선택지가 갈리는 지점입니다. 표를 기준으로 각 방법의 쓰임새와 운영상의 차이를 비교해두면 이후 판단이 훨씬 쉬워집니다.

table-driven test, race detector, benchmark, httptest를 기본 품질 도구로 사용해야 합니다.

품질 축	검증 방법	완료 기준
정확성	정상/실패 케이스를 자동화합니다.	핵심 시나리오가 재현 가능하게 통과합니다.
회귀 방지	버그 수정 시 동일 케이스를 테스트로 남깁니다.	같은 장애가 다시 배포되지 않습니다.
운영성	로그, 메트릭, 알림을 확인합니다.	문제가 생겼을 때 원인 추적 경로가 있습니다.

🐹 Go 완전 가이드

가이드 사용법

Go를 실무 흐름으로 이해하기

백엔드 / 시스템 개발

구조 다이어그램

학습 흐름

아키텍처 관점

환경 설정

기본 문법

에러 처리

인터페이스

Goroutine & Channel

HTTP 서버

Go 실무 설계

Go 운영 기준

Go 검증 전략

🐹 Go 완전 가이드

가이드 사용법

Go를 실무 흐름으로 이해하기

백엔드 / 시스템 개발

구조 다이어그램

학습 흐름

아키텍처 관점

환경 설정

기본 문법

에러 처리

인터페이스

Goroutine & Channel

HTTP 서버

Go 실무 설계

Go 운영 기준

Go 검증 전략