Merge pull request #932 from devlights/add-gcflags-ldflags-debug-release-build

Author: devlights

examples/singleapp/gcflags_ldflags_debug_release_build/.gitignore

@@ -0,0 +1,3 @@
+normal
+debug
+release

examples/singleapp/gcflags_ldflags_debug_release_build/README.md

@@ -0,0 +1,32 @@
+# これは何？
+
+Goにてデバッグビルドするときと、リリースビルドするときによく利用するフラグについて。
+
+## デバッグ
+
+```sh
+go build -gcflags "all=-N -l" -o debug main.go
+```
+
+### オプションの意味
+
+```
+      # gcflags の all=-N -l の意味 (goコンパイラに対しての指示) (go tool compile -help)
+      #   all= は全てのパッケージが対象という意味
+      #   -N   は最適化無効という意味 (No optimization)
+      #   -l   はインライン化無効という意味 (No inlining)
+```
+
+## リリース
+
+```sh
+go build -ldflags "-s -w" -o release main.go
+```
+
+### オプションの意味
+
+```
+      # ldflags の -s -w の意味 (リンカに対しての指示) (go tool link -help)
+      #    -s   はシンボルテーブル削除という意味
+      #    -w   はDWARF情報削除という意味（デバッグ情報）
+```

examples/singleapp/gcflags_ldflags_debug_release_build/Taskfile.yml

@@ -0,0 +1,25 @@
+# https://taskfile.dev
+
+version: '3'
+
+vars:
+  RE1: main\.go.*inlining call.*$
+
+tasks:
+  default:
+    cmds:
+      # gcflags の all=-m -N -l の意味 (goコンパイラに対しての指示) (go tool compile -help)
+      #   all= は全てのパッケージが対象という意味
+      #   -m   はビルド時のコンパイラの詳細情報を出力せよという意味
+      #   -N   は最適化無効という意味 (No optimization)
+      #   -l   はインライン化無効という意味 (No inlining)
+      - cmd: go build -gcflags "all=-m -N -l" -o debug main.go 2>&1 | grep "{{.RE1}}"
+        ignore_error: true
+      - cmd: go build -gcflags "all=-m" -o normal main.go 2>&1 | grep "{{.RE1}}"
+        ignore_error: true
+      # ldflags の -s -w の意味 (リンカに対しての指示) (go tool link -help)
+      #    -s   はシンボルテーブル削除という意味
+      #    -w   はDWARF情報削除という意味（デバッグ情報）
+      - cmd: go build -gcflags "all=-m" -ldflags "-s -w" -o release main.go 2>&1 | grep "{{.RE1}}"
+        ignore_error: true
+      - ls -l {normal,debug,release} | awk 'NF>1 {print $5, $NF}'

examples/singleapp/gcflags_ldflags_debug_release_build/main.go

@@ -0,0 +1,63 @@
+package main
+
+import (
+	"io"
+	"log"
+	"sync"
+	"time"
+)
+
+func main() {
+	log.SetFlags(0)
+	log.SetOutput(io.Discard)
+
+	if err := run(); err != nil {
+		panic(err)
+	}
+}
+
+// この関数は最適化が有効な場合、直接 v*2 になる可能性があり
+// インライン化が有効な場合、インライン化される可能性がある
+func calc(v int) int {
+	v1 := v
+	v2 := 2
+	return v1 * v2
+}
+
+func run() error {
+	const (
+		COUNT   = 10000000
+		WORKERS = 4
+	)
+	var (
+		ch = make(chan int)
+		wg sync.WaitGroup
+	)
+
+	// producer
+	wg.Add(1)
+	go func(ch chan<- int) {
+		defer wg.Done()
+		defer close(ch)
+
+		for i := range COUNT {
+			ch <- calc(i)
+		}
+	}(ch)
+
+	time.Sleep(10 * time.Millisecond)
+
+	// consumer
+	for range WORKERS {
+		wg.Add(1)
+		go func(ch <-chan int) {
+			for v := range ch {
+				log.Println(v)
+			}
+		}(ch)
+	}
+
+	wg.Done()
+
+	return nil
+}