Go Basic on Joonlog

Go 코딩 규칙(Idiomatic Go)

Tue, 17 Jun 2025 09:00:00 +0900

변수 및 함수 이름

camelCase 사용
축약어는 중간이나 끝에 (예: userID, httpServer)
간결하고 의미 있는 이름 권장 (err, ok, i, r 등)

1
2


var userID int
func getUserInfo() {}

타입 및 인터페이스

타입 이름은 PascalCase
인터페이스는 동작 기반 이름 사용 (Reader, Closer 등)

1
2
3
4
5
6
7


type FileReader interface {
 Read(p []byte) (n int, err error)
}

type User struct {
 Name string
}

에러 처리

if err != nil 패턴이 기본
에러 발생 즉시 처리하고 빠르게 반환
에러 메시지는 소문자로 시작하고 마침표는 생략

1
2
3
4


f, err := os.Open("file.txt")
if err != nil {
 return err
}

패키지 이름 규칙

항상 소문자
단수형
의미는 명확하되 짧게 (strings, math, http 등)
밑줄(_), 복수형, 접두사 등은 지양

주석 스타일

공개 함수나 타입에는 주석 필수
함수명으로 시작하는 문장형 주석 사용

1
2
3
4
5
6
7


// Add는 두 숫자의 합 반환
/*
Add는 두 숫자의 합 반환
*/
func Add(a, b int) int {
 return a + b
}

Go 기본 명령어

Mon, 16 Jun 2025 09:00:00 +0900

컴파일 명령어

go build
- main 패키지면 현재 디렉터리에 실행 파일 생성
  - main 패키지 없다면 실행 파일 생성 안 됨 (컴파일만 됨)

go install

main 패키지면 실행 파일이 $GOBIN 또는 $GOPATH/bin 에 생성됨
- main 패키지 없다면 실행 파일 없음, 캐시에만 저장
아래 코드처럼 실행 가능한 go로 작성된 cli 툴들 가져오기 가능(GOBIN에 등록됐을 시)
1

go install github.com/user/tool@latest
환경 변수 설정

1
2
3
4
5
6
7
8


# GOBIN 기본 경로 확인
go env GOBIN
# 없으면 GOPATH/bin이 기본
go env GOPATH

# 실행 파일 전역 사용을 위해 PATH 설정
echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.bashrc
source ~/.bashrc

모듈 라이브러리 명령어

go get
- main 패키지가 없는 모듈 라이브러리(go.mod)에 추가하는 명령어
1

go get github.com/user/package
go mod tidy
- go.mod에 필요 없는 모듈 제거
- 누락된 의존성 자동 추가

코드 스타일 정리

들여쓰기, 공백, import 정렬 등을 표준화

1
2
3


go fmt # 현재 디렉토리 전체 포맷
go fmt file.go # 특정 파일만 포맷
go fmt ./... # 하위 디렉토리까지 전체 포맷. bash 문법이 아닌 go 문법.

Go Public / Private 식별자

Sat, 31 May 2025 09:00:00 +0900

Go 언어는 public, private 키워드 없이 이름의 첫 글자 대소문자만으로 식별자의 공개 여부를 결정 함수, 변수, 인터페이스 등 모든 식별자에 적용되는 규칙

공개(Public) 식별자와 비공개(Private) 식별자

대문자로 시작하는 이름 → 해당 패키지 외부에서도 접근 가능 (공개)

소문자로 시작하는 이름 → 해당 패키지 내부에서만 사용 가능 (비공개)

1
2
3
4
5
6
7
8
9


// 공개 함수
func Reverse(s string) string {
 return reverseTwo(s)
}

// 비공개 함수
func reverseTwo(s string) string {
 // 문자열 뒤집기
}

Public 함수 접근 예시

패키지 구조

1
2
3
4
5
6


GolangTraining/
 ├── 02_library/
 │ └── stringutil/
 │ └── reverse.go
 └── 01_helloWorld/
 └── hello.go

reverse.go (패키지 내부 함수 정의)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13


package stringutil

func Reverse(s string) string {
 return reverseTwo(s)
}

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

hello.go (외부 패키지에서 import)

 1
 2
 3
 4
 5
 6
 7
 8
 9
10


package main

import (
 "fmt"
 "github.com/goestoeleven/GolangTraining/02_library/stringutil"
)

func main() {
 fmt.Println(stringutil.Reverse("Hello, Go!"))
}

실행 결과
1

!oG ,olleH

Private 함수에 접근하려 할 경우

reverseTwo는 stringutil 내부에서만 사용 가능하므로, 아래와 같이 사용하면 컴파일 에러 발생
1

fmt.Println(stringutil.reverseTwo("Hello"))
컴파일 에러
1

undefined: stringutil.reverseTwo

Go Blank Identifier

Fri, 30 May 2025 09:00:00 +0900

Go에서 _는 사용하지 않는 값 또는 결과를 버리는 용도로 사용
읽기 전용이며, 어떤 값도 저장하거나 참조 불가
실제 메모리에 변수로 존재하지 않음

주요 사용 예

다중 리턴값 중 일부 무시할 때

1

val, _ := someFunc() // 두 번째 리턴값 무시

반복문에서 인덱스나 값을 무시할 때

1
2
3


for _, v := range list {
 fmt.Println(v) // 인덱스는 필요 없을 때
}

인터페이스 구현 시, 사용하지 않는 메서드 인자 무시

1
2
3


func handler(_ int) {
 // 인자를 사용하지 않음
}

import된 패키지를 코드에서 직접 사용하지 않을 때

1

import _ "net/http/pprof" // side-effect용 import

변수 선언 후 사용하지 않아 에러가 날 때 회피용

1
2


msg := "hello"
_ = msg

Go iota

Thu, 29 May 2025 09:00:00 +0900

Go 특유의 상수용 자동 증가 매크로 키워드

const 블록에서만 사용 가능
첫 번째 상수는 0부터 시작
아래로 한 줄씩 내려갈 때마다 1씩 자동 증가

기본 예제

1
2
3
4
5


const (
 A = iota // 0
 B // 1
 C // 2
)

iota는 행 기준으로 증가 → 위 예제에서 A=0, B=1, C=2

중간에 값을 지정해도 다음 iota는 계속 증가

1
2
3
4
5


const (
 A = iota // 0
 B = 100 // 고정값
 C = iota // 2
)

비트 연산자와 조합 (플래그)

1
2
3
4
5


const (
 Read = 1 << iota // 1 << 0 → 1
 Write // 1 << 1 → 2
 Exec // 1 << 2 → 4
)

→ Read=1, Write=2, Exec=4 → 비트 플래그 용도로 자주 사용

여러 개 동시에 선언할 때도 동작

1
2
3
4


const (
 x, y = iota, iota // x=0, y=0
 a, b = iota, iota // a=1, b=1
)

Go의 기본 자료형과 단축 선언

Wed, 28 May 2025 09:00:00 +0900

정수형
- int, int8, int16, int32, int64
- uint 계열은 양수 전용
- 보통은 그냥 int 사용
실수형
- float32, float64 (기본은 float64)
- 소수점 숫자 저장용
문자형
- rune: 유니코드 문자 하나 (int32)
- 'A', '한' , 이모티콘을 포함한 문자 저장 가능
문자열
- string: UTF-8 인코딩 문자열
- 불변(immutable)
- 슬라이싱, 인덱싱 가능
Boolean
- bool: true / false
- 조건문 등에 사용
Byte
- byte는 uint8의 alias
- 문자열 인코딩 관련 작업에서 자주 사용

1
2
3
4
5
6


var i int = 10
var f float64 = 3.14
var ch rune = '가'
var s string = "hello"
var b bool = true
var b byte = 'A' // byte는 uint8

기본값

Go에서는 변수 선언 시 초기값을 주지 않으면 자료형에 맞는 기본값(zero value)으로 초기화됨

1
2
3
4


var i int // 0
var s string // ""
var b bool // false
var f float64 // 0.0

출력 포맷 (`fmt.Printf`)

포맷	설명	예시
`%d`	정수	`fmt.Printf("%d", 10)`
`%f`	실수	`fmt.Printf("%.2f", 3.14)`
`%s`	문자열	`fmt.Printf("%s", "go")`
`%c`	문자	`fmt.Printf("%c", 'A')`
`%v`	기본 포맷	`fmt.Printf("%v", 변수)`
`%T`	타입	`fmt.Printf("%T", 변수)`

형 변환

Go는 자동 형 변환 없음 → 반드시 명시적 변환 필요
정수 ↔ 실수, 정수 ↔ uint 변환 시 주의

1
2
3


var a int = 42
var b float64 = float64(a)
var c uint = uint(b)

rune <===> string 인덱싱 시 주의
- string[index]는 byte 리턴 → 유니코드 문자는 rune으로 변환해야 제대로 출력 가능
1 2 3

s := "가나다" fmt.Printf("%c\n", s[0]) // 깨짐 fmt.Printf("%c\n", []rune(s)[0]) // 가

단축 선언 (`:=`)

타입 추론과 동시에 변수 선언
주로 함수 내부에서 사용

1
2
3
4


name := "Go" // string
score := 95 // int
rate := 4.5 // float64
valid := true // bool

Go 설치와 실행

Mon, 26 May 2025 09:00:00 +0900

공식 문서: https://go.dev/doc/install

설치

1
2
3


wget https://go.dev/dl/go1.24.3.linux-amd64.tar.gz
tar -xvzf go1.24.3.linux-amd64.tar.gz
sudo mv go /usr/local/

.bashrc에 영구 적용

1
2
3
4
5
6
7


go env GOROOT

# 위 명령어에서 나온 값 변수로 저장
# 기본값: /usr/local/go
echo 'export GOROOT=$(go env GOROOT)' >> ~/.bashrc
echo 'export PATH=$PATH:$GOROOT/bin' >> ~/.bashrc
source ~/.bashrc

설치 확인
1

go version

go 모듈 초기화
- Go 프로젝트 시작 시 go.mod 파일을 만들고 의존성 관리 가능하게 함
- 보통 하나의 프로젝트(리포지토리)당 한 번만 실행
- 모듈 이름은 GitHub 경로처럼 짓는 것이 관례이며, 실제로 GitHub에 올릴 경우 import 경로로 사용됨
1 2

mkdir go-basic && cd go-basic go mod init github.com/joonlog/go-basic
- 이 명령은 현재 디렉토리를 github.com/joonlog/go-basic이라는 이름의 모듈로 선언함
  
  → GitHub에 올리지 않아도 작동하지만, 나중에 배포하려면 실제 리포지토리 경로와 맞춰야 함
- go.mod 파일 생성됨
1 2 3 4

go-workspace/ └── myproject/ ← 모듈 디렉터리 ├── go.mod ← 모듈 정보 └── main.go

main.go 작성

package main의 목적: go run / go build로 실행 가능한 바이너리 생성 반드시 func main 존재 필요
1 2 3 4 5 6 7

package main import "fmt" func main() { fmt.Println("Hello, Go!") }

실행
1

go run main.go