Goのセットアップや、hello world の出力から基本構文に触れます。

Goセットアップと基本構文(Basic Syntax) - Golang learning step 1-1

<a href="https://roadmap.sh/" rel="noopener noreferrer" target="_blank">roadmap.sh</a> > <a href="https://roadmap.sh/golang" rel="noopener noreferrer" target="_blank">Go</a> > Learn the Basics > Basic Syntax の学習を進めていきます。
<div class="img_wrap"><amp-img layout="responsive" src="/images/posts/268/01.png" width="1576" height="1146" alt="学習箇所"></div>
※ 学習メモとしての記録ですが、反復学習の際の道しるべとなるよう、ですます調で記載しています。
<h2 id="contents">contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#basic-syntax%E5%9F%BA%E6%9C%AC%E6%A7%8B%E6%96%87">Basic Syntax（基本構文）</a></li>
<li><a href="#%E7%92%B0%E5%A2%83%E8%A8%AD%E5%AE%9A">環境設定</a>
<ol>
<li><a href="#go-%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">Go インストール</a></li>
<li><a href="#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90">プロジェクトの作成</a></li>
</ol>
</li>
<li><a href="#hello-world">Hello World</a></li>
<li><a href="#%E8%A4%87%E6%95%B0%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E8%AA%AD%E3%81%BF%E8%BE%BC%E3%81%BF">複数パッケージの読み込み</a></li>
<li><a href="#%E5%9F%BA%E6%9C%AC%E6%A7%8B%E6%96%87%E3%81%BE%E3%81%A8%E3%82%81">基本構文まとめ</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
<ul>
<li>チップ: Apple M2 Pro</li>
<li>OS: macOS Sonoma</li>
<li>go version: go1.23.2 darwin/arm64</li>
</ul>
<h2 id="basic-syntax基本構文">Basic Syntax（基本構文）</h2>
<a href="https://roadmap.sh/golang" rel="noopener noreferrer" target="_blank">https://roadmap.sh/golang</a>
Go の基本的な構文についてのセクション。Go プログラムの実行方法、パッケージのインポート、main関数など。
Go の開発環境を整え、Hello world していくなかで、最も基本の構文を抑えましょう。までが学習範囲です。
<ul>
<li>[official] <a href="https://go.dev/doc/tutorial/getting-started" rel="noopener noreferrer" target="_blank">Go Tutorial: Getting started</a></li>
<li>[article] <a href="https://gobyexample.com/hello-world" rel="noopener noreferrer" target="_blank">Go by Example: Hello World</a></li>
<li>[article] <a href="https://www.w3schools.com/go/go_syntax.php" rel="noopener noreferrer" target="_blank">W3schools: Go Syntax</a></li>
</ul>
<h2 id="環境設定">環境設定</h2>
<h3 id="go-インストール">Go インストール</h3>
公式リファレンスでは、Golang 公式サイトの<a href="https://go.dev/doc/install" rel="noopener noreferrer" target="_blank">ダウンロードとインストール</a>の手順に従いインストールするようにアナウンスがありますが、本記事では goenv を使ってインストールします。goenv を用いれば、Go のバージョン管理について、バージョンアップや他のバージョンを利用したい時に簡単に対応できます。
<a href="https://formulae.brew.sh/formula/goenv" rel="noopener noreferrer" target="_blank">goenv - Homebrew</a>
goenv インストール
<pre><code class="hljs language-shell">brew install goenv
</code></pre>
goenv バージョン確認
<pre><code class="hljs language-shell">goenv -v

-> goenv 2.2.7
</code></pre>
goenv の初期化スクリプトを追記します。~/.zshrc に以下を追記
<pre><code class="hljs language-shell">export GOENV_ROOT="$HOME/.goenv"
export PATH="$GOENV_ROOT/bin:$PATH"
eval "$(goenv init -)"
</code></pre>
追記を反映させるためにシェルを再読み込みします。
<pre><code class="hljs language-shell">source ~/.zshrc
</code></pre>
インストール可能なバージョンを表示します。
<pre><code class="hljs language-shell">goenv install -l
</code></pre>
バージョンを指定して最新バージョンをインストールします。
<pre><code class="hljs language-shell">goenv install 1.23.2
</code></pre>
インストール済み Go バージョンを確認します。
<pre><code class="hljs language-shell">goenv versions
</code></pre>
インストールしたバージョンを使用するように設定します。
<pre><code class="hljs language-shell">goenv global 1.23.2
</code></pre>
ここまで実施すると、go コマンドが使用できるようになっています。
go コマンドで Go のバージョンを確認します。
<pre><code class="hljs language-shell">go version

-> go version go1.23.2 darwin/arm64
</code></pre>
go コマンドのパスが通っているか確認すると、goenv 経由であることがわかります。
<pre><code class="hljs language-shell">which go

-> /Users/your_username/.goenv/shims/go
</code></pre>
これでインストールは完了です。
<h3 id="プロジェクトの作成">プロジェクトの作成</h3>
Go アプリケーションを作成する場所と、アプリケーションをセットアップします。
<h4 id="ディレクトリを作成">ディレクトリを作成</h4>
プロジェクトは、簡単に言えば IDE（エディター）で開いて編集するディレクトリです。アプリケーションのルートディレクトリ。ここに Go のファイルを設置し、実装していきます。
Go 1.11 以降、Go Modules を使用することでプロジェクトを $GOPATH に依存せず、任意のディレクトリで管理可能になりました。
<ul>
<li><a href="https://go.dev/ref/mod" rel="noopener noreferrer" target="_blank">Go Modules Reference</a></li>
<li><a href="https://go.dev/blog/using-go-modules" rel="noopener noreferrer" target="_blank">Using Go Modules</a></li>
</ul>
任意の場所にディレクトリを作成します。（UI上からディレクトリを作成してもOK）
<pre><code class="hljs language-shell">mkdir myproject
</code></pre>
<h4 id="go-モジュールを初期化">Go モジュールを初期化</h4>
作成したディレクトリへ入ります。以下 go コマンドを実行し、Go モジュールを初期化します。go.mod が作成されます。
<pre><code class="hljs language-shell">go mod init github.com/yourusername/myproject
</code></pre>
Go では、インポートパスがユニークである（かぶってはいけない）必要があります。ソースコードを Github 管理している場合は上記のようなパスをつけるのが慣習です。
ただし、サンプルでローカルに作るだけなら、重複しなければ良いので以下のようなパスでも可能です。
<pre><code class="hljs language-shell">go mod init myproject
</code></pre>
これで、Go プログラムを実行していく環境が作成できました。
<h2 id="hello-world">Hello World</h2>
Hello World を出力するプログラムを実装しつつ、基本構文を確認していきます。
main.go を作成し、以下を記述。これが最も基本的な構文です。
<pre><code class="hljs language-shell">package main

import "fmt"

func main() {
 fmt.Println("Hello, Go!")
}
</code></pre>
<ul>
<li>package
<ul>
<li>Go では、すべてのプログラムがパッケージの一部。先頭に package キーワードを使用して定義する。今回の場合、このプログラムは main パッケージに属するという定義になる。
<ul>
<li>Goアプリケーションの最もトップのファイルは必ず package main である必要がある</li>
</ul>
</li>
</ul>
</li>
<li>import
<ul>
<li>パッケージをインポートすることができる。ここでは fmt パッケージをインポートしている。fmtパッケージは、入出力の書式設定と文字列操作を行うための標準ライブラリ。</li>
</ul>
</li>
<li>func main() {}
<ul>
<li>関数。中括弧 {} 内のコードがすべて実行される。</li>
<li>fmt.Println()
<ul>
<li>fmt パッケージから利用可能な関数 Println() を実行している。テキストを出力/表示するために使用される。"Hello World!" を出力する。</li>
</ul>
</li>
</ul>
</li>
</ul>
go run コマンドで main.go を実行すると、hello world が出力されます。
<pre><code class="hljs language-shell">% go run main.go

-> hello world
</code></pre>
プログラムをバイナリにビルドするときは、go build で行います。
<pre><code class="hljs language-shell">go build main.go
</code></pre>
ここでは main.go をビルドしたので、main というビルドされたバイナリが作成されます。これを直接実行もできます。
<pre><code class="hljs language-shell">./main

-> hello world
</code></pre>
hello world を出力するまでができました。
<h2 id="複数パッケージの読み込み">複数パッケージの読み込み</h2>
import でパッケージを読み込む際に、複数のパッケージを読み込む時は 2 通りの方法があります。
まず 1 つは、import キーワードを羅列して 1 つずつ import していく方法。
<pre><code class="hljs language-golang">package main

import "fmt"
import "math"
import "strings"
</code></pre>
2 つ目は、ブロックインポート（グループ化されたインポート宣言）を使う方法です。
<pre><code class="hljs language-golang">package main

import (
 "fmt"
 "math"
 "strings"
)
</code></pre>
一般的には後者のグループ化されたインポート宣言が推奨されています。前者の場合、多数のパッケージをインポートする際に冗長になる点や、go fmt コマンド（コードフォマットを自動で行ってくれる）を実行すると前者で書いてあっても後者のブロックインポートになる点などが挙げられます。
<h2 id="基本構文まとめ">基本構文まとめ</h2>
<ul>
<li>Go 1.11 以降なら、プロジェクトを作成する場所はどこでも良い</li>
<li>プロジェクトを作成したら、Go モジュールを初期化する</li>
<li>package は必ず宣言する必要がある
<ul>
<li>Goアプリケーションの最もトップのファイルは必ず package main である必要がある</li>
</ul>
</li>
<li>使用するパッケージは import 文で宣言
<ul>
<li>複数読み込む場合は、グループ化されたインポート宣言を使用するのがが望ましい</li>
</ul>
</li>
</ul>
<hr>
[Next] <a href="/posts/269">Step 1-2: 変数と宣言(Variables and declaration) </a>

<a href="https://roadmap.sh/" rel="noopener noreferrer" target="_blank">roadmap.sh</a> > <a href="https://roadmap.sh/golang" rel="noopener noreferrer" target="_blank">Go</a> > Learn the Basics > Basic Syntax の学習を進めていきます。
<div class="img_wrap"><img src="/images/posts/268/01.png" width="1576" height="1146" alt="学習箇所"></div>
※ 学習メモとしての記録ですが、反復学習の際の道しるべとなるよう、ですます調で記載しています。
<h2 id="contents">contents</h2>
<ol>
<li><a href="#%E9%96%8B%E7%99%BA%E7%92%B0%E5%A2%83">開発環境</a></li>
<li><a href="#basic-syntax%E5%9F%BA%E6%9C%AC%E6%A7%8B%E6%96%87">Basic Syntax（基本構文）</a></li>
<li><a href="#%E7%92%B0%E5%A2%83%E8%A8%AD%E5%AE%9A">環境設定</a>
<ol>
<li><a href="#go-%E3%82%A4%E3%83%B3%E3%82%B9%E3%83%88%E3%83%BC%E3%83%AB">Go インストール</a></li>
<li><a href="#%E3%83%97%E3%83%AD%E3%82%B8%E3%82%A7%E3%82%AF%E3%83%88%E3%81%AE%E4%BD%9C%E6%88%90">プロジェクトの作成</a></li>
</ol>
</li>
<li><a href="#hello-world">Hello World</a></li>
<li><a href="#%E8%A4%87%E6%95%B0%E3%83%91%E3%83%83%E3%82%B1%E3%83%BC%E3%82%B8%E3%81%AE%E8%AA%AD%E3%81%BF%E8%BE%BC%E3%81%BF">複数パッケージの読み込み</a></li>
<li><a href="#%E5%9F%BA%E6%9C%AC%E6%A7%8B%E6%96%87%E3%81%BE%E3%81%A8%E3%82%81">基本構文まとめ</a></li>
</ol>
<h2 id="開発環境">開発環境</h2>
<ul>
<li>チップ: Apple M2 Pro</li>
<li>OS: macOS Sonoma</li>
<li>go version: go1.23.2 darwin/arm64</li>
</ul>
<h2 id="basic-syntax基本構文">Basic Syntax（基本構文）</h2>
<a href="https://roadmap.sh/golang" rel="noopener noreferrer" target="_blank">https://roadmap.sh/golang</a>
Go の基本的な構文についてのセクション。Go プログラムの実行方法、パッケージのインポート、main関数など。
Go の開発環境を整え、Hello world していくなかで、最も基本の構文を抑えましょう。までが学習範囲です。
<ul>
<li>[official] <a href="https://go.dev/doc/tutorial/getting-started" rel="noopener noreferrer" target="_blank">Go Tutorial: Getting started</a></li>
<li>[article] <a href="https://gobyexample.com/hello-world" rel="noopener noreferrer" target="_blank">Go by Example: Hello World</a></li>
<li>[article] <a href="https://www.w3schools.com/go/go_syntax.php" rel="noopener noreferrer" target="_blank">W3schools: Go Syntax</a></li>
</ul>
<h2 id="環境設定">環境設定</h2>
<h3 id="go-インストール">Go インストール</h3>
公式リファレンスでは、Golang 公式サイトの<a href="https://go.dev/doc/install" rel="noopener noreferrer" target="_blank">ダウンロードとインストール</a>の手順に従いインストールするようにアナウンスがありますが、本記事では goenv を使ってインストールします。goenv を用いれば、Go のバージョン管理について、バージョンアップや他のバージョンを利用したい時に簡単に対応できます。
<a href="https://formulae.brew.sh/formula/goenv" rel="noopener noreferrer" target="_blank">goenv - Homebrew</a>
goenv インストール
<pre><code class="hljs language-shell">brew install goenv
</code></pre>
goenv バージョン確認
<pre><code class="hljs language-shell">goenv -v

-> goenv 2.2.7
</code></pre>
goenv の初期化スクリプトを追記します。~/.zshrc に以下を追記
<pre><code class="hljs language-shell">export GOENV_ROOT="$HOME/.goenv"
export PATH="$GOENV_ROOT/bin:$PATH"
eval "$(goenv init -)"
</code></pre>
追記を反映させるためにシェルを再読み込みします。
<pre><code class="hljs language-shell">source ~/.zshrc
</code></pre>
インストール可能なバージョンを表示します。
<pre><code class="hljs language-shell">goenv install -l
</code></pre>
バージョンを指定して最新バージョンをインストールします。
<pre><code class="hljs language-shell">goenv install 1.23.2
</code></pre>
インストール済み Go バージョンを確認します。
<pre><code class="hljs language-shell">goenv versions
</code></pre>
インストールしたバージョンを使用するように設定します。
<pre><code class="hljs language-shell">goenv global 1.23.2
</code></pre>
ここまで実施すると、go コマンドが使用できるようになっています。
go コマンドで Go のバージョンを確認します。
<pre><code class="hljs language-shell">go version

-> go version go1.23.2 darwin/arm64
</code></pre>
go コマンドのパスが通っているか確認すると、goenv 経由であることがわかります。
<pre><code class="hljs language-shell">which go

-> /Users/your_username/.goenv/shims/go
</code></pre>
これでインストールは完了です。
<h3 id="プロジェクトの作成">プロジェクトの作成</h3>
Go アプリケーションを作成する場所と、アプリケーションをセットアップします。
<h4 id="ディレクトリを作成">ディレクトリを作成</h4>
プロジェクトは、簡単に言えば IDE（エディター）で開いて編集するディレクトリです。アプリケーションのルートディレクトリ。ここに Go のファイルを設置し、実装していきます。
Go 1.11 以降、Go Modules を使用することでプロジェクトを $GOPATH に依存せず、任意のディレクトリで管理可能になりました。
<ul>
<li><a href="https://go.dev/ref/mod" rel="noopener noreferrer" target="_blank">Go Modules Reference</a></li>
<li><a href="https://go.dev/blog/using-go-modules" rel="noopener noreferrer" target="_blank">Using Go Modules</a></li>
</ul>
任意の場所にディレクトリを作成します。（UI上からディレクトリを作成してもOK）
<pre><code class="hljs language-shell">mkdir myproject
</code></pre>
<h4 id="go-モジュールを初期化">Go モジュールを初期化</h4>
作成したディレクトリへ入ります。以下 go コマンドを実行し、Go モジュールを初期化します。go.mod が作成されます。
<pre><code class="hljs language-shell">go mod init github.com/yourusername/myproject
</code></pre>
Go では、インポートパスがユニークである（かぶってはいけない）必要があります。ソースコードを Github 管理している場合は上記のようなパスをつけるのが慣習です。
ただし、サンプルでローカルに作るだけなら、重複しなければ良いので以下のようなパスでも可能です。
<pre><code class="hljs language-shell">go mod init myproject
</code></pre>
これで、Go プログラムを実行していく環境が作成できました。
<h2 id="hello-world">Hello World</h2>
Hello World を出力するプログラムを実装しつつ、基本構文を確認していきます。
main.go を作成し、以下を記述。これが最も基本的な構文です。
<pre><code class="hljs language-shell">package main

import "fmt"

func main() {
 fmt.Println("Hello, Go!")
}
</code></pre>
<ul>
<li>package
<ul>
<li>Go では、すべてのプログラムがパッケージの一部。先頭に package キーワードを使用して定義する。今回の場合、このプログラムは main パッケージに属するという定義になる。
<ul>
<li>Goアプリケーションの最もトップのファイルは必ず package main である必要がある</li>
</ul>
</li>
</ul>
</li>
<li>import
<ul>
<li>パッケージをインポートすることができる。ここでは fmt パッケージをインポートしている。fmtパッケージは、入出力の書式設定と文字列操作を行うための標準ライブラリ。</li>
</ul>
</li>
<li>func main() {}
<ul>
<li>関数。中括弧 {} 内のコードがすべて実行される。</li>
<li>fmt.Println()
<ul>
<li>fmt パッケージから利用可能な関数 Println() を実行している。テキストを出力/表示するために使用される。"Hello World!" を出力する。</li>
</ul>
</li>
</ul>
</li>
</ul>
go run コマンドで main.go を実行すると、hello world が出力されます。
<pre><code class="hljs language-shell">% go run main.go

-> hello world
</code></pre>
プログラムをバイナリにビルドするときは、go build で行います。
<pre><code class="hljs language-shell">go build main.go
</code></pre>
ここでは main.go をビルドしたので、main というビルドされたバイナリが作成されます。これを直接実行もできます。
<pre><code class="hljs language-shell">./main

-> hello world
</code></pre>
hello world を出力するまでができました。
<h2 id="複数パッケージの読み込み">複数パッケージの読み込み</h2>
import でパッケージを読み込む際に、複数のパッケージを読み込む時は 2 通りの方法があります。
まず 1 つは、import キーワードを羅列して 1 つずつ import していく方法。
<pre><code class="hljs language-golang">package main

import "fmt"
import "math"
import "strings"
</code></pre>
2 つ目は、ブロックインポート（グループ化されたインポート宣言）を使う方法です。
<pre><code class="hljs language-golang">package main

import (
 "fmt"
 "math"
 "strings"
)
</code></pre>
一般的には後者のグループ化されたインポート宣言が推奨されています。前者の場合、多数のパッケージをインポートする際に冗長になる点や、go fmt コマンド（コードフォマットを自動で行ってくれる）を実行すると前者で書いてあっても後者のブロックインポートになる点などが挙げられます。
<h2 id="基本構文まとめ">基本構文まとめ</h2>
<ul>
<li>Go 1.11 以降なら、プロジェクトを作成する場所はどこでも良い</li>
<li>プロジェクトを作成したら、Go モジュールを初期化する</li>
<li>package は必ず宣言する必要がある
<ul>
<li>Goアプリケーションの最もトップのファイルは必ず package main である必要がある</li>
</ul>
</li>
<li>使用するパッケージは import 文で宣言
<ul>
<li>複数読み込む場合は、グループ化されたインポート宣言を使用するのがが望ましい</li>
</ul>
</li>
</ul>
<hr>
[Next] <a href="/posts/269">Step 1-2: 変数と宣言(Variables and declaration) </a>

Author