カテゴリ: Go言語 更新日: 2026/01/06

Go言語のクロスコンパイル入門!異なるOS向けにビルドする方法

Go言語のクロスコンパイルの基本!異なるOS向けにビルドする方法
Go言語のクロスコンパイルの基本!異なるOS向けにビルドする方法

先生と生徒の会話形式で理解しよう

生徒

「先生、私のパソコンはWindowsなんですけど、作ったGoプログラムをMacやLinuxでも動かしたいです。」

先生

「それならGoのクロスコンパイル機能を使えば、簡単に異なるOS向けのバイナリを作ることができます。」

生徒

「クロスコンパイルって何ですか?」

先生

「クロスコンパイルとは、開発している環境とは違うOSやCPUアーキテクチャ向けにプログラムをコンパイルすることです。たとえばWindowsで開発したプログラムをLinux向けに変換できます。」

生徒

「どうやってやるんですか?」

先生

「簡単です。環境変数を設定してgo buildを実行するだけです。」

1. クロスコンパイルの基本手順

1. クロスコンパイルの基本手順
1. クロスコンパイルの基本手順

Go言語では、GOOSGOARCHという環境変数を使ってターゲットOSとCPUを指定できます。例えば、WindowsでLinux向けバイナリを作る場合は以下のように設定します。


SET GOOS=linux
SET GOARCH=amd64
go build -o myapp main.go

これでmyappという名前のLinux向け実行ファイルが生成されます。

2. Mac向けのクロスコンパイル

2. Mac向けのクロスコンパイル
2. Mac向けのクロスコンパイル

Mac向けのバイナリを作りたい場合は、OSをdarwinに指定します。


SET GOOS=darwin
SET GOARCH=amd64
go build -o myapp main.go

これでMacの64ビット環境で実行可能なバイナリが作れます。

3. 注意すべきポイント

3. 注意すべきポイント
3. 注意すべきポイント

クロスコンパイルでは、OS固有の機能やライブラリを使っている場合、正しく動作しないことがあります。標準ライブラリを使う分には問題ありません。

また、Windows向けはmyapp.exe、LinuxやMac向けはmyappというように拡張子の違いに注意してください。

4. CPUアーキテクチャの指定

4. CPUアーキテクチャの指定
4. CPUアーキテクチャの指定

32ビットや64ビットなどCPUアーキテクチャを指定することも可能です。


SET GOOS=linux
SET GOARCH=386
go build -o myapp main.go

これで32ビット版のLinux向けバイナリが生成されます。開発者はターゲット環境に合わせてアーキテクチャを指定できます。

5. 複数OS向けにまとめてビルド

5. 複数OS向けにまとめてビルド
5. 複数OS向けにまとめてビルド

複数のOS向けにビルドする場合は、スクリプトを使うと便利です。


SET GOOS=linux & SET GOARCH=amd64 & go build -o myapp-linux main.go
SET GOOS=windows & SET GOARCH=amd64 & go build -o myapp-windows.exe main.go
SET GOOS=darwin & SET GOARCH=amd64 & go build -o myapp-mac main.go

このようにすると、一度に複数環境向けのバイナリを生成できます。

6. 依存関係の確認

6. 依存関係の確認
6. 依存関係の確認

クロスコンパイルを行う前に、モジュール管理ファイルgo.modを確認しておくと安全です。go mod tidyで依存関係を整理してからビルドすることをおすすめします。

7. 実践的な使い方

7. 実践的な使い方
7. 実践的な使い方

クロスコンパイルを使うと、開発者は自分のPCだけでなく、他のOSユーザー向けに簡単にプログラムを配布できます。チーム開発やオープンソースプロジェクトで特に役立ちます。

Go言語のクロスコンパイルは、環境変数とgo buildを理解するだけで簡単に使える非常に便利な機能です。

Go言語を基礎からスッキリ学びたい人や、 文法だけでなく「実用的な使い方」まで押さえたい人には、 定番の入門書がこちらです。

基礎からわかるGo言語をAmazonで見る

※ Amazon広告リンク

まとめ

まとめ
まとめ

クロスコンパイルで広がるGo言語の可能性

今回の記事では、Go言語の大きな特徴の一つであるクロスコンパイルについて、基本から実践まで順を追って確認してきました。 Go言語では、開発しているOSとは異なる環境向けに実行ファイルを作成できるため、Windows、Linux、Macといった複数のOSを意識した開発が非常にスムーズに行えます。 特別なツールを追加しなくても、環境変数とgo buildコマンドだけで完結する点は、初心者にとっても大きなメリットです。

記事前半では、GOOSGOARCHという二つの環境変数が、クロスコンパイルの要であることを学びました。 この二つを正しく指定することで、ターゲットとなるOSとCPUアーキテクチャを自由に切り替えられます。 たとえばLinux向け、Mac向け、Windows向けといった形で、同じソースコードから複数の実行ファイルを生成できる点は、配布や検証の場面で非常に役立ちます。

実務や学習で役立つポイント

注意点として、OS固有の機能や外部ライブラリに依存している場合は、クロスコンパイル後に正しく動作しない可能性があることも確認しました。 そのため、標準ライブラリ中心で実装することや、事前に依存関係を整理しておくことが重要になります。 go mod tidyを使って依存関係をきれいにしておく習慣は、クロスコンパイルに限らず、Go言語開発全体で役立ちます。

また、複数のOS向けに一括でビルドする方法も紹介しました。 スクリプトとしてまとめておくことで、配布用の実行ファイルを短時間で準備できるようになります。 チーム開発や個人開発、ツール配布など、さまざまな場面で活用できる実践的なテクニックと言えるでしょう。

まとめの中のサンプル確認


# Linux・Windows・Mac向けにまとめてビルドする例
SET GOOS=linux   & SET GOARCH=amd64 & go build -o app-linux main.go
SET GOOS=windows & SET GOARCH=amd64 & go build -o app-windows.exe main.go
SET GOOS=darwin  & SET GOARCH=amd64 & go build -o app-mac main.go

このようにコマンドを整理しておくと、開発環境が一つでも、複数の実行環境に対応した配布物を簡単に用意できます。 クロスコンパイルは難しい印象を持たれがちですが、実際にはGo言語の基本を理解していればすぐに実践できる技術です。

先生と生徒の振り返り会話

生徒

「最初は難しそうだと思っていましたが、環境変数を設定するだけで、 WindowsからLinuxやMac向けの実行ファイルが作れるのは驚きでした。」

先生

「そうですね。Go言語はクロスコンパイルが標準で用意されているので、 開発者が環境差をあまり意識せずに済むのが強みです。」

生徒

「配布用のツールやチーム開発でも、同じソースコードで対応できるのは便利ですね。」

先生

「その通りです。まずは標準ライブラリ中心で作り、クロスコンパイルを試す。 慣れてきたらスクリプト化して効率化する、という流れがおすすめですよ。」

生徒

「これなら、Go言語で作ったプログラムをいろいろな環境の人に安心して配れそうです。」

Go言語のクロスコンパイルは、学習段階から実務まで幅広く役立つ重要な機能です。 基本を押さえておくだけで、対応できる開発の幅が一気に広がります。 今回学んだ内容をもとに、ぜひ実際のプロジェクトや小さなツール作成で活用してみてください。

関連セミナーのご案内

【超入門】ゼロから始めるGo言語プログラミング:最速で「動くアプリ」を作るマンツーマン指導

「プログラミングの仕組み」が根本からわかる。Go言語でバックエンド開発の第一歩を。

本講座を受講することで、単なる文法の暗記ではなく、「プログラムがコンピュータの中でどう動いているか」という本質的な理解につながります。シンプルながら強力なGo言語(Golang)を通じて、現代のバックエンドエンジニアに求められる基礎体力を最短距離で身につけます。

具体的な開発内容と環境

【つくるもの】
ターミナル(黒い画面)上で動作する「対話型計算プログラム」や、データを整理して表示する「ミニ・ツール」をゼロから作成します。自分の書いたコードが形になる感動を体験してください。

【開発環境】
プロの現場でシェアNo.1のVisual Studio Code (VS Code)を使用します。インストールから日本語化、Go言語用の拡張機能設定まで、現場基準の環境を一緒に構築します。

この60分で得られる3つの理解

1. 環境構築の完全な理解

「なぜ動くのか」という設定の仕組みを理解し、今後の独学で詰まらない土台を作ります。

2. Go言語の基本構造(変数・型)

データの種類やメモリの概念など、他言語にも通じるプログラミングの本質を学びます。

3. 読みやすいコードの書き方

ただ動くだけでなく、誰が見ても分かりやすい「綺麗なコード」を書くための考え方を伝授します。

※本講座は、将来的にバックエンドエンジニアクラウドインフラに興味がある未経験者のためのエントリー講座です。マンツーマン形式により、あなたの理解度に合わせて進行します。

セミナー画像

初めてのGo言語を一緒に学びましょう!

カテゴリの一覧へ
新着記事
New1
Swift
Swiftのnilとは?Optionalとの関係や初期化について初心者向けにやさしく解説!
New2
Go言語
Go言語のinit関数の役割と使い方!プログラム起動時の初期化処理
New3
Go言語
Go言語のマップの順序保証がない理由と扱い方の工夫をやさしく解説!初心者でもわかる基本知識
New4
Kotlin
Kotlinのforループの基本!範囲・配列・コレクションの繰り返し処理
人気記事
No.1
Java&Spring記事人気No1
Kotlin
Kotlinのsettings.gradleファイルを完全解説!初心者でもわかるプロジェクト設定の基本
No.2
Java&Spring記事人気No2
Go言語
Swiftの配列(Array)の使い方を完全ガイド!初心者でもわかるデータのまとめ方
No.3
Java&Spring記事人気No3
Go言語
Go言語のSQLインジェクション対策を完全解説!初心者でも安全なデータベース操作がわかる
No.4
Java&Spring記事人気No4
Swift
Swiftの高階関数map・filter・reduceを完全解説!初心者でもわかる配列操作の基本
No.5
Java&Spring記事人気No5
Go言語
Swiftの文字列操作を完全ガイド!初心者でもわかるStringの基本
No.6
Java&Spring記事人気No6
Kotlin
KotlinのRoomで複雑なクエリを使いこなす!初心者でもわかる応用テクニック
No.7
Java&Spring記事人気No7
Go言語
Go言語のgo installコマンドの役割とインストール先の仕組みを徹底解説!
No.8
Java&Spring記事人気No8
Swift
Swift Playgroundの使い方を完全解説!初心者に最適な学習環境の始め方