Go Academy · 강의

패키지: Go 코드 구성

패키지 선언, 임포트 및 내보낸 이름

패키지: Go 코드 구성은(는) CoddyKit의 무료 Go Academy 강의입니다. 이것은 4개 중 1번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Go Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

패키지란 무엇인가요?

모든 Go 소스 파일은 패키지에 속합니다. 패키지 이름은 모든 파일의 맨 위에 표시됩니다. 패키지는 관련 코드를 하나로 묶고 가시성을 제어합니다:

// file: math/calc.go
package math

// Exported — accessible from other packages (capital letter)
func Add(a, b int) int { return a + b }

// Unexported — package-private (lowercase)
func helper() int { return 42 }

패키지 선언과 가져오기 경로

패키지 이름(짧은 이름)은 가져오기 경로(전체 모듈 경로/디렉터리)와 다릅니다:

// Import path: github.com/myapp/util/stringutil
// Package name: stringutil (last segment by convention)
package stringutil

func Reverse(s string) string {
    r := []rune(s)
    for i, j := 0, len(r)-1; i < j; i, j = i+1, j-1 {
        r[i], r[j] = r[j], r[i]
    }
    return string(r)
}

패키지 가져오기

다른 패키지를 가져오려면 import를 사용합니다. Go에서는 가져온 모든 패키지를 사용해야 합니다:

package main

import (
    "fmt"                         // standard library
    "strings"                     // standard library
    "github.com/myapp/util/math"  // third-party or local
)

func main() {
    fmt.Println(strings.ToUpper("hello"))
    fmt.Println(math.Add(1, 2))
}

공개 식별자와 비공개 식별자

대문자로 시작하는 식별자는 공개됩니다. 소문자로 시작하는 식별자는 비공개이며 패키지 내부에서만 사용할 수 있습니다:

package server

// Exported: accessible from other packages
type Server struct {
    Addr    string   // exported field
    timeout int      // unexported field
}

// Exported method
func (s *Server) Start() error { return nil }

// Unexported helper
func (s *Server) listen() {}

main 패키지와 func main

main 패키지는 실행 파일을 정의하는 특별한 패키지입니다. main 함수는 진입점입니다:

package main

import "fmt"

func main() {
    fmt.Println("Hello, Go!")
    // Program starts here and ends here
}

// All other packages are libraries — no main() needed

init() 함수

각 패키지에는 하나 이상의 init() 함수가 있을 수 있습니다. 이 함수들은 main()보다 먼저 선언된 순서대로 자동 실행됩니다:

package config

import "fmt"

var DB string

func init() {
    DB = "localhost:5432/mydb"
    fmt.Println("config package initialized")
}

// init runs once when the package is first imported
// Multiple init() functions per file/package are allowed

부수 효과만을 위한 빈 가져오기

빈 식별자를 사용하면 패키지의 init() 부수 효과만을 위해 패키지를 가져올 수 있습니다:

package main

import (
    "database/sql"
    _ "github.com/lib/pq"  // registers PostgreSQL driver via init()
)

func main() {
    db, err := sql.Open("postgres", "host=localhost dbname=test")
    _ = db
    _ = err
}

별칭을 사용한 가져오기

이름 충돌을 피하거나 이름을 짧게 만들기 위해 가져올 때 패키지 이름을 바꿀 수 있습니다:

package main

import (
    "fmt"
    gomath "math"              // alias to avoid collision
    mymath "github.com/me/math"
)

func main() {
    fmt.Println(gomath.Sqrt(16))     // 4
    fmt.Println(mymath.Add(1, 2))    // 3
}

패키지 이름 지정 규칙

Go 패키지의 이름 지정 규칙은 다음과 같습니다:

짧고 소문자로 된 한 단어를 사용합니다: http, json, fmt
디렉터리 이름과 일치시킵니다: util/stringutil/ → 패키지 stringutil
패키지 이름에는 밑줄이나 camelCase를 사용하지 않습니다
util, common, helper와 같은 일반적인 이름은 피합니다
패키지 이름은 식별자의 일부이므로 httplib.HTTPClient보다 http.Client를 선호합니다

순환 가져오기

Go에서는 순환 가져오기를 허용하지 않습니다. B가 A를 가져오는 경우 패키지 A는 B를 가져올 수 없습니다. 공유 코드를 세 번째 패키지로 분리하여 해결합니다:

// WRONG: A imports B, B imports A — compile error
// package a imports "myapp/b"
// package b imports "myapp/a"

// SOLUTION: extract shared types to package c
// package a imports "myapp/c"
// package b imports "myapp/c"
// No circular dependency

빠른 확인

Go에서 식별자를 공개로 만드는 조건은 무엇인가요?

요약: 패키지

패키지의 주요 개념:

모든 파일은 package name으로 시작합니다
대문자는 공개, 소문자는 비공개(패키지 전용)를 의미합니다
전체 경로로 가져오고 짧은 패키지 이름으로 사용합니다
init()은 main()보다 먼저 자동 실행됩니다
부수 효과만을 위해 빈 가져오기 _ "pkg"를 사용합니다
순환 가져오기는 허용되지 않습니다

자주 묻는 질문

“패키지: Go 코드 구성” 강의는 무료인가요?

네 — “패키지: Go 코드 구성” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Go Academy 강의 전체를 잠금 해제할 수 있습니다. Go Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“패키지: Go 코드 구성”에서 뭘 배우나요?

패키지 선언, 임포트 및 내보낸 이름 브라우저에서 직접 실행하는 실습 코드로 Go Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Go Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Go Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 1번째 강의입니다.

“패키지: Go 코드 구성” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Go Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Go Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

← Go Academy(으)로 돌아가기