diff --git a/pages.ko/common/go-bug.md b/pages.ko/common/go-bug.md new file mode 100644 index 0000000000..8b8df82538 --- /dev/null +++ b/pages.ko/common/go-bug.md @@ -0,0 +1,8 @@ +# go bug + +> 버그 보고. +> 더 많은 정보: . + +- 버그 보고를 시작하기 위해 웹 페이지 열기: + +`go bug` diff --git a/pages.ko/common/go-build.md b/pages.ko/common/go-build.md new file mode 100644 index 0000000000..83fc52f8e2 --- /dev/null +++ b/pages.ko/common/go-build.md @@ -0,0 +1,20 @@ +# go build + +> Go 소스 컴파일. +> 더 많은 정보: . + +- 'package main' 파일 컴파일 (출력은 확장자가 없는 파일 이름): + +`go build {{경로/대상/main.go}}` + +- 출력 파일 이름을 지정하여 컴파일: + +`go build -o {{경로/대상/바이너리}} {{경로/대상/소스.go}}` + +- 패키지 컴파일: + +`go build -o {{경로/대상/바이너리}} {{경로/대상/패키지}}` + +- 데이터 경쟁 감지를 활성화하여 메인 패키지를 실행 파일로 컴파일: + +`go build -race -o {{경로/대상/실행_파일}} {{경로/대상/메인/패키지}}` diff --git a/pages.ko/common/go-clean.md b/pages.ko/common/go-clean.md new file mode 100644 index 0000000000..5f674ceeb0 --- /dev/null +++ b/pages.ko/common/go-clean.md @@ -0,0 +1,20 @@ +# go clean + +> 오브젝트 파일과 캐시 파일 제거. +> 더 많은 정보: . + +- 실제로 제거하지 않고 제거 명령 출력: + +`go clean -n` + +- 빌드 캐시 삭제: + +`go clean -cache` + +- 모든 캐시된 테스트 결과 삭제: + +`go clean -testcache` + +- 모듈 캐시 삭제: + +`go clean -modcache` diff --git a/pages.ko/common/go-doc.md b/pages.ko/common/go-doc.md new file mode 100644 index 0000000000..81692a0112 --- /dev/null +++ b/pages.ko/common/go-doc.md @@ -0,0 +1,24 @@ +# go doc + +> 패키지나 심볼에 대한 문서 보기. +> 더 많은 정보: . + +- 현재 패키지에 대한 문서 보기: + +`go doc` + +- 패키지 문서 및 내보내진 기호 보기: + +`go doc {{encoding/json}}` + +- 기호의 문서도 함께 보기: + +`go doc -all {{encoding/json}}` + +- 소스도 함께 보기: + +`go doc -all -src {{encoding/json}}` + +- 특정 기호 보기: + +`go doc -all -src {{encoding/json.Number}}` diff --git a/pages.ko/common/go-env.md b/pages.ko/common/go-env.md new file mode 100644 index 0000000000..f33ccf0770 --- /dev/null +++ b/pages.ko/common/go-env.md @@ -0,0 +1,20 @@ +# go env + +> Go 툴체인이 사용하는 환경 변수를 관리합니다. +> 더 많은 정보: . + +- 모든 환경 변수 표시: + +`go env` + +- 특정 환경 변수 표시: + +`go env {{GOPATH}}` + +- 환경 변수를 특정 값으로 설정: + +`go env -w {{GOBIN}}={{경로/대상/폴더}}` + +- 환경 변수의 값을 재설정: + +`go env -u {{GOBIN}}` diff --git a/pages.ko/common/go-fix.md b/pages.ko/common/go-fix.md new file mode 100644 index 0000000000..6fc187f1c6 --- /dev/null +++ b/pages.ko/common/go-fix.md @@ -0,0 +1,8 @@ +# go fix + +> 패키지를 새로운 API를 사용하도록 업데이트. +> 더 많은 정보: . + +- 패키지를 새로운 API를 사용하도록 업데이트: + +`go fix {{packages}}` diff --git a/pages.ko/common/go-fmt.md b/pages.ko/common/go-fmt.md new file mode 100644 index 0000000000..238a3d12f5 --- /dev/null +++ b/pages.ko/common/go-fmt.md @@ -0,0 +1,24 @@ +# go fmt + +> Go 소스 파일을 포맷하고 변경된 파일 이름을 출력합니다. +> 더 많은 정보: . + +- 현재 디렉토리의 Go 소스 파일 포맷: + +`go fmt` + +- 가져오기 경로(`$GOPATH/src`)에 있는 특정 Go 패키지 포맷: + +`go fmt {{경로/대상/패키지}}` + +- 현재 디렉토리와 모든 하위 디렉토리의 패키지 포맷 (`...`을 주의하세요): + +`go fmt {{./...}}` + +- 포맷 명령이 실행될 때 어떤 명령이 실행될지 출력하고 실제로 수정하지 않음: + +`go fmt -n` + +- 포맷 명령이 실행될 때 실행되는 명령을 출력: + +`go fmt -x` diff --git a/pages.ko/common/go-generate.md b/pages.ko/common/go-generate.md new file mode 100644 index 0000000000..f3ae91a2fa --- /dev/null +++ b/pages.ko/common/go-generate.md @@ -0,0 +1,8 @@ +# go generate + +> 소스 파일 내에서 명령을 실행하여 Go 파일 생성. +> 더 많은 정보: . + +- 소스 파일 내에서 명령을 실행하여 Go 파일 생성: + +`go generate` diff --git a/pages.ko/common/go-get.md b/pages.ko/common/go-get.md new file mode 100644 index 0000000000..bf815b2f6a --- /dev/null +++ b/pages.ko/common/go-get.md @@ -0,0 +1,16 @@ +# go get + +> 의존성 패키지를 추가하거나 레거시 GOPATH 모드에서 패키지를 다운로드. +> 더 많은 정보: . + +- 모듈 모드에서 `go.mod`에 지정된 패키지를 추가하거나 GOPATH 모드에서 패키지 설치: + +`go get {{example.com/pkg}}` + +- 모듈 인식 모드에서 지정된 버전으로 패키지 수정: + +`go get {{example.com/pkg}}@{{v1.2.3}}` + +- 지정된 패키지 제거: + +`go get {{example.com/pkg}}@{{none}}` diff --git a/pages.ko/common/go-install.md b/pages.ko/common/go-install.md new file mode 100644 index 0000000000..fa5297dbed --- /dev/null +++ b/pages.ko/common/go-install.md @@ -0,0 +1,20 @@ +# go install + +> import 경로로 지정된 패키지를 컴파일하고 설치. +> 더 많은 정보: . + +- 현재 패키지를 컴파일하고 설치: + +`go install` + +- 특정 로컬 패키지를 컴파일하고 설치: + +`go install {{경로/대상/패키지}}` + +- 현재 디렉토리의 `go.mod`를 무시하고 프로그램의 최신 버전 설치: + +`go install {{golang.org/x/tools/gopls}}@{{최신}}` + +- 현재 디렉토리의 `go.mod`에 의해 선택된 버전으로 프로그램 설치: + +`go install {{golang.org/x/tools/gopls}}` diff --git a/pages.ko/common/go-list.md b/pages.ko/common/go-list.md new file mode 100644 index 0000000000..7ff5684a8f --- /dev/null +++ b/pages.ko/common/go-list.md @@ -0,0 +1,20 @@ +# go list + +> 패키지 또는 모듈 나열. +> 더 많은 정보: . + +- 패키지 나열: + +`go list ./...` + +- 표준 패키지 나열: + +`go list std` + +- JSON 형식으로 패키지 나열: + +`go list -json time net/http` + +- 모듈 종속성과 이용 가능한 업데이트 나열: + +`go list -m -u all` diff --git a/pages.ko/common/go-mod.md b/pages.ko/common/go-mod.md new file mode 100644 index 0000000000..49203b7cb9 --- /dev/null +++ b/pages.ko/common/go-mod.md @@ -0,0 +1,24 @@ +# go mod + +> 모듈 유지 관리. +> 더 많은 정보: . + +- 현재 디렉터리에 새 모듈 초기화: + +`go mod init {{모듈_이름}}` + +- 모듈을 로컬 캐시로 다운로드: + +`go mod download` + +- 누락된 모듈 추가 및 사용하지 않는 모듈 제거: + +`go mod tidy` + +- 의존성이 예상된 내용을 가지고 있는지 확인: + +`go mod verify` + +- 모든 의존성의 소스를 vendor 디렉터리에 복사: + +`go mod vendor` diff --git a/pages.ko/common/go-run.md b/pages.ko/common/go-run.md new file mode 100644 index 0000000000..ac95565003 --- /dev/null +++ b/pages.ko/common/go-run.md @@ -0,0 +1,12 @@ +# go run + +> Go 코드를 컴파일하고 바이너리를 저장하지 않고 실행. +> 더 많은 정보: . + +- Go 파일 실행: + +`go run {{경로/대상/파일.go}}` + +- 메인 Go 패키지 실행: + +`go run {{경로/대상/패키지}}` diff --git a/pages.ko/common/go-test.md b/pages.ko/common/go-test.md new file mode 100644 index 0000000000..e389550f59 --- /dev/null +++ b/pages.ko/common/go-test.md @@ -0,0 +1,28 @@ +# go test + +> Go 패키지를 테스트합니다 (`_test.go`로 끝나는 파일이어야 함). +> 더 많은 정보: . + +- 현재 디렉터리에 있는 패키지 테스트: + +`go test` + +- 현재 디렉터리의 패키지를 [v]자세히 테스트: + +`go test -v` + +- 현재 디렉터리와 모든 하위 디렉터리의 패키지 테스트 (`...` 주의): + +`go test -v ./...` + +- 현재 디렉터리의 패키지를 테스트하고 모든 벤치마크 실행: + +`go test -v -bench .` + +- 현재 디렉터리의 패키지를 테스트하고 50초 동안 모든 벤치마크 실행: + +`go test -v -bench . -benchtime {{50s}}` + +- 커버리지 분석으로 패키지 테스트: + +`go test -cover` diff --git a/pages.ko/common/go-tool.md b/pages.ko/common/go-tool.md new file mode 100644 index 0000000000..2e64e7bc98 --- /dev/null +++ b/pages.ko/common/go-tool.md @@ -0,0 +1,25 @@ +# go tool + +> Go 도구 또는 명령 실행. +> Go 명령을 독립 실행형 바이너리로 실행하여 주로 디버깅에 사용. +> 더 많은 정보: . + +- 사용 가능한 도구 나열: + +`go tool` + +- go link 도구 실행: + +`go tool link {{경로/대상/main.o}}` + +- 실행될 명령을 출력하지만 실제로 실행하지 않음 (`whereis`와 유사): + +`go tool -n {{명령}} {{인수들}}` + +- 지정된 도구에 대한 문서 보기: + +`go tool {{명령}} --help` + +- 사용 가능한 모든 교차 컴파일 대상 나열: + +`go tool dist list` diff --git a/pages.ko/common/go-version.md b/pages.ko/common/go-version.md new file mode 100644 index 0000000000..c0fee9626b --- /dev/null +++ b/pages.ko/common/go-version.md @@ -0,0 +1,12 @@ +# go version + +> Go 버전을 표시. +> 더 많은 정보: . + +- 버전 표시: + +`go version` + +- 특정 실행 파일을 빌드하는 데 사용된 Go 버전 표시: + +`go version {{경로/대상/실행파일}}` diff --git a/pages.ko/common/go-vet.md b/pages.ko/common/go-vet.md new file mode 100644 index 0000000000..158e6081c2 --- /dev/null +++ b/pages.ko/common/go-vet.md @@ -0,0 +1,29 @@ +# go vet + +> Go 소스 코드를 검사하고 의심스러운 구조를 보고합니다 (예: Go 소스 파일을 린트). +> 문제가 발견되면 go vet는 0이 아닌 종료 코드를 반환하고, 문제가 없으면 0 종료 코드를 반환합니다. +> 더 많은 정보: . + +- 현재 디렉토리의 Go 패키지 검사: + +`go vet` + +- 지정된 경로의 Go 패키지 검사: + +`go vet {{경로/대상/파일_또는_폴더}}` + +- go vet로 실행할 수 있는 사용 가능한 검사 목록 나열: + +`go tool vet help` + +- 특정 검사의 세부정보 및 플래그 보기: + +`go tool vet help {{검사_이름}}` + +- 문제 있는 줄과 그 주변의 N 줄을 표시: + +`go vet -c={{N}}` + +- 분석 결과와 오류를 JSON 형식으로 출력: + +`go vet -json` diff --git a/pages.ko/common/go.md b/pages.ko/common/go.md new file mode 100644 index 0000000000..53f095f996 --- /dev/null +++ b/pages.ko/common/go.md @@ -0,0 +1,33 @@ +# go + +> Go 소스 코드를 관리. +> `build`와 같은 일부 하위 명령에는 자체 사용 설명서가 있습니다. +> 더 많은 정보: . + +- 패키지 다운로드 및 설치 (import 경로로 지정): + +`go get {{패키지_경로}}` + +- 소스 파일 컴파일 및 실행 (`main` 패키지를 포함해야 함): + +`go run {{파일}}.go` + +- 소스 파일을 지정한 이름의 실행 파일로 컴파일: + +`go build -o {{실행_파일}} {{파일}}.go` + +- 현재 디렉토리에 있는 패키지 컴파일: + +`go build` + +- 현재 패키지의 모든 테스트 케이스 실행 (`_test.go`로 끝나야 함): + +`go test` + +- 현재 패키지 컴파일 및 설치: + +`go install` + +- 현재 디렉토리에 새 모듈 초기화: + +`go mod init {{모듈_이름}}` diff --git a/pages.ko/common/gofmt.md b/pages.ko/common/gofmt.md new file mode 100644 index 0000000000..1f908992ba --- /dev/null +++ b/pages.ko/common/gofmt.md @@ -0,0 +1,20 @@ +# gofmt + +> Go 소스 코드를 포맷합니다. +> 더 많은 정보: . + +- 파일을 포맷하고 결과를 콘솔에 표시: + +`gofmt {{source.go}}` + +- 파일을 포맷하여 원본 파일을 덮어쓰기: + +`gofmt -w {{source.go}}` + +- 파일을 포맷하고 코드를 단순화한 후 원본 파일을 덮어쓰기: + +`gofmt -s -w {{source.go}}` + +- 모든 오류(불필요한 오류 포함)를 출력: + +`gofmt -e {{source.go}}` diff --git a/pages.ko/common/goimports.md b/pages.ko/common/goimports.md new file mode 100644 index 0000000000..fb1c824456 --- /dev/null +++ b/pages.ko/common/goimports.md @@ -0,0 +1,20 @@ +# goimports + +> Go 언어의 import 줄을 업데이트하여 누락된 항목을 추가하고 참조되지 않은 항목을 제거합니다. +> 더 많은 정보: . + +- 완료된 import 소스 파일 표시: + +`goimports {{경로/대상/파일.go}}` + +- 결과를 `stdout` 대신 소스 파일에 다시 작성: + +`goimports -w {{경로/대상/파일.go}}` + +- 차이점을 표시하고 결과를 소스 파일에 다시 작성: + +`goimports -w -d {{경로/대상/파일.go}}` + +- 3rd-party 패키지 이후에 import 접두사 문자열 설정 (쉼표로 구분된 목록): + +`goimports -local {{경로/대상/패키지1,경로/대상/패키지2,...}} {{경로/대상/파일.go}}` diff --git a/pages.ko/common/golangci-lint.md b/pages.ko/common/golangci-lint.md new file mode 100644 index 0000000000..8ba03a2d0d --- /dev/null +++ b/pages.ko/common/golangci-lint.md @@ -0,0 +1,16 @@ +# golangci-lint + +> 병렬 처리, 스마트하고 빠른 Go 린터 실행 도구로 주요 IDE와 통합되며 YAML 구성을 지원합니다. +> 더 많은 정보: . + +- 현재 폴더에서 린터 실행: + +`golangci-lint run` + +- 활성화 및 비활성화된 린터 목록 표시 (참고: 비활성화된 린터는 마지막에 표시되며, 활성화된 린터로 착각하지 마세요): + +`golangci-lint linters` + +- 특정 린터를 이 실행에서 [E]nable: + +`golangci-lint run --enable {{린터}}`