Laragon番外編7｜Goを手動追加・切り替える｜Go Modules・Web API・VS Codeまで確認

Laragonでは、PHPやNode.js、Pythonだけでなく、Goも複数バージョンを切り替えながら利用できます。

今回はLaragon番外編7として、Go公式サイトからWindows版のZIPファイルを取得し、Laragonへ手動でGoを追加する方法を実際に確認していきます。

Goを追加して終わりではありません。

Go Modulesでテストプロジェクトを作成し、VS CodeでGoの開発環境を整えたあと、Go標準パッケージのnet/httpを使ってWeb APIを作成します。

さらにHTMLとJavaScriptのfetch()からAPIを呼び出し、最後はDelveを使ったデバッグまで確認します。

現在Laragonで使われているGoを確認する

まず、新しいGoを追加する前に、現在LaragonでどのGoが使われているか確認します。

LaragonのTerminalを開いて、次のコマンドを実行します。

where.exe go
go version

where.exe go
go version

where.exe goでは、現在PATHから呼び出されるgo.exeの場所を確認できます。

今回の作業開始時点では、次のGoが使われていました。

C:\laragon\bin\go\go1.24.1\bin\go.exe

go versionでは、Go 1.24.1が有効になっていることを確認できました。

GOROOT・GOPATH・GOMODCACHEも確認する

Goでは、最初のうちは似た名前に見えるパスがいくつか登場します。

今回は次の3つも確認しました。

go env GOROOT
go env GOPATH
go env GOMODCACHE

go env GOROOT
go env GOPATH
go env GOMODCACHE

作業開始時点では、GOROOTはGo 1.24.1を指していました。

一方、GOPATHとGOMODCACHEはLaragon側の共通領域に設定されています。

LaragonへGoを手動追加する

次に、Go 1.27.1をLaragonへ追加します。

追加前にLaragonのGoメニューを確認すると、今回の環境ではGo 1.23.4とGo 1.24.1が登録されており、Go 1.24.1が選択されていました。

手動追加の全体像は次のようになります。

Go公式サイトからWindows版ZIPを取得する

Go公式サイトのダウンロードページを開きます。

今回の検証では、Windows 64bit環境で次のZIPを使用しました。

go1.27.1.windows-amd64.zip

Laragonへ手動追加するため、今回はWindows用インストーラーではなくZIPアーカイブを選びます。

SHA-256を確認する

ダウンロード後は、ZIPファイルのSHA-256も確認しました。

PowerShellではGet-FileHashを利用できます。

Get-FileHash -Algorithm SHA256 "$env:USERPROFILE\Downloads\go1.27.1.windows-amd64.zip"

Get-FileHash -Algorithm SHA256 "$env:USERPROFILE\Downloads\go1.27.1.windows-amd64.zip"

今回確認したZIPは、公式サイトに掲載されていたSHA-256と一致しました。

ZIPの中身を確認する

ZIPを展開すると、最上位にgoフォルダがあります。

その中には、bin、pkg、srcなどGo本体として必要なファイルが含まれています。

goフォルダをgo1.27.1へ変更して配置する

展開したgoフォルダを、そのままLaragonへ置くのではなく、

go1.27.1

へリネームします。

そのあと次の場所へ配置します。

C:\laragon\bin\go\

今回の最終状態は次のようになりました。

C:\laragon\bin\go\
├─ go1.23.4
├─ go1.24.1
└─ go1.27.1

Laragonを再起動してGo 1.27.1へ切り替える

フォルダを追加したあと、Laragonを再起動します。

再起動後にGoのバージョンメニューを開くと、新しく追加したGo 1.27.1が認識されました。

Go 1.27.1を選択します。

Go 1.27.1へ切り替わったことを確認する

バージョンを切り替えたら、新しいTerminalを開いて確認します。

where.exe go
go version
go env GOROOT
go env GOPATH
go env GOMODCACHE

where.exe go
go version
go env GOROOT
go env GOPATH
go env GOMODCACHE

今回の実機確認値：

C:\laragon\bin\go\go1.27.1\bin\go.exe
go version go1.27.1 windows/amd64
C:\laragon\bin\go\go1.27.1
C:\laragon\usr\go
C:\laragon\usr\go\pkg\mod

C:\laragon\bin\go\go1.27.1\bin\go.exe
go version go1.27.1 windows/amd64
C:\laragon\bin\go\go1.27.1
C:\laragon\usr\go
C:\laragon\usr\go\pkg\mod

今回の環境では、

C:\laragon\bin\go\go1.27.1\bin\go.exe

が使用され、

go version go1.27.1 windows/amd64

と表示されました。

切り替え後の環境では、次の構成になりました。

今回の実機確認値は次のとおりです。

GOROOT

C:\laragon\bin\go\go1.27.1

GOPATH

C:\laragon\usr\go

GOMODCACHE

C:\laragon\usr\go\pkg\mod

Go Modulesでテストプロジェクトを作る

Goの切り替えが終わったので、実際にプロジェクトを作成します。

今回はLaragonのwww配下へ、

C:\laragon\www\laragon-go-test

を作りました。

Go Modulesもここで初期化します。

cd C:\laragon\www

mkdir laragon-go-test

cd laragon-go-test

go mod init example.com/laragon-go-test

cd C:\laragon\www

mkdir laragon-go-test

cd laragon-go-test

go mod init example.com/laragon-go-test

生成されたgo.modは次の内容です。

module example.com/laragon-go-test

go 1.27.1

module example.com/laragon-go-test

go 1.27.1

VS CodeでGoの開発環境を整える

プロジェクトフォルダへ移動した状態で、VS Codeを開きます。

code .

VS CodeでGoを書く場合は、Go Team at Googleが提供するGo拡張を利用できます。

今回の環境ではGo拡張自体はインストール済みでしたが、無効になっていたため有効化しました。

gopls・DelveなどをGo 1.27.1に合わせる

Go 1.27.1へ切り替えたあと、VS CodeからGo関連ツールの更新通知が表示されました。

今回更新された主なツールは次のとおりです。

すべて正常に更新されました。

最初のGoプログラムを動かす

まずはWeb APIへ進む前に、最小限のGoプログラムを動かします。

main.goを作成します。

package main

import "fmt"

func main() {
	fmt.Println("Laragon Go Environment Check")
}

package main

import "fmt"

func main() {
	fmt.Println("Laragon Go Environment Check")
}

実行します。

go run .

go run .

正常であれば、

Laragon Go Environment Check

と表示されます。

go runとgo buildの違い

go run .は、開発中にプログラムをビルドしてそのまま実行するのに便利です。

一方、実行ファイルとして残したい場合はgo buildを使えます。

go build -o laragon-go-test.exe .

.\laragon-go-test.exe

go build -o laragon-go-test.exe .

.\laragon-go-test.exe

Windowsでは、

laragon-go-test.exe

が生成されます。

GoでWeb APIを作る

ここからはWeb開発へ進みます。

Goには標準ライブラリとしてnet/httpが用意されているため、追加フレームワークを入れなくてもHTTPサーバーを動かせます。

今回は、

/api/status

へアクセスすると、現在のGo環境をJSONで返すAPIを作ります。

最初のAPI確認用コードは

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"runtime"
)

type Status struct {
	Status       string `json:"status"`
	Language     string `json:"language"`
	GoVersion    string `json:"goVersion"`
	OS           string `json:"os"`
	Architecture string `json:"architecture"`
}

func main() {
	http.HandleFunc("/api/status", func(w http.ResponseWriter, r *http.Request) {
		status := Status{
			Status:       "success",
			Language:     "Go",
			GoVersion:    runtime.Version(),
			OS:           runtime.GOOS,
			Architecture: runtime.GOARCH,
		}

		w.Header().Set("Content-Type", "application/json; charset=utf-8")
		json.NewEncoder(w).Encode(status)
	})

	fmt.Println("Laragon Go Environment Check")

	if err := http.ListenAndServe("127.0.0.1:8080", nil); err != nil {
		fmt.Println("Server error:", err)
	}
}

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"runtime"
)

type Status struct {
	Status       string `json:"status"`
	Language     string `json:"language"`
	GoVersion    string `json:"goVersion"`
	OS           string `json:"os"`
	Architecture string `json:"architecture"`
}

func main() {
	http.HandleFunc("/api/status", func(w http.ResponseWriter, r *http.Request) {
		status := Status{
			Status:       "success",
			Language:     "Go",
			GoVersion:    runtime.Version(),
			OS:           runtime.GOOS,
			Architecture: runtime.GOARCH,
		}

		w.Header().Set("Content-Type", "application/json; charset=utf-8")
		json.NewEncoder(w).Encode(status)
	})

	fmt.Println("Laragon Go Environment Check")

	if err := http.ListenAndServe("127.0.0.1:8080", nil); err != nil {
		fmt.Println("Server error:", err)
	}
}

です。

サーバーを起動します。

go run .

go run .

ブラウザから次へアクセスします。

http://127.0.0.1:8080/api/status

今回は次のJSONを取得できました。

{
  "status": "success",
  "language": "Go",
  "goVersion": "go1.27.1",
  "os": "windows",
  "architecture": "amd64"
}

127.0.0.1:8080

HTMLとJavaScriptからGo Web APIを呼び出す

APIだけでも動作確認はできますが、Web開発としてもう一歩進めて、HTMLとJavaScriptからGo APIを呼び出します。

今回の最終的な通信の流れは次のようになります。

最終的なプロジェクトでは、

static
└─ index.html

を追加します。

Go側もHTMLを配信できるように変更します。

最終版のmain.goは

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"runtime"
)

type Status struct {
	Status       string `json:"status"`
	Language     string `json:"language"`
	GoVersion    string `json:"goVersion"`
	OS           string `json:"os"`
	Architecture string `json:"architecture"`
}

func main() {
	http.HandleFunc("/api/status", func(w http.ResponseWriter, r *http.Request) {
		if r.Method != http.MethodGet {
			w.Header().Set("Allow", http.MethodGet)
			http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
			return
		}

		status := Status{
			Status:       "success",
			Language:     "Go",
			GoVersion:    runtime.Version(),
			OS:           runtime.GOOS,
			Architecture: runtime.GOARCH,
		}

		w.Header().Set("Content-Type", "application/json; charset=utf-8")
		json.NewEncoder(w).Encode(status)
	})

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		if r.URL.Path != "/" {
			http.NotFound(w, r)
			return
		}

		http.ServeFile(w, r, "static/index.html")
	})

	fmt.Println("Laragon Go Environment Check")

	if err := http.ListenAndServe("127.0.0.1:8080", nil); err != nil {
		fmt.Println("Server error:", err)
	}
}

package main

import (
	"encoding/json"
	"fmt"
	"net/http"
	"runtime"
)

type Status struct {
	Status       string `json:"status"`
	Language     string `json:"language"`
	GoVersion    string `json:"goVersion"`
	OS           string `json:"os"`
	Architecture string `json:"architecture"`
}

func main() {
	http.HandleFunc("/api/status", func(w http.ResponseWriter, r *http.Request) {
		if r.Method != http.MethodGet {
			w.Header().Set("Allow", http.MethodGet)
			http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
			return
		}

		status := Status{
			Status:       "success",
			Language:     "Go",
			GoVersion:    runtime.Version(),
			OS:           runtime.GOOS,
			Architecture: runtime.GOARCH,
		}

		w.Header().Set("Content-Type", "application/json; charset=utf-8")
		json.NewEncoder(w).Encode(status)
	})

	http.HandleFunc("/", func(w http.ResponseWriter, r *http.Request) {
		if r.URL.Path != "/" {
			http.NotFound(w, r)
			return
		}

		http.ServeFile(w, r, "static/index.html")
	})

	fmt.Println("Laragon Go Environment Check")

	if err := http.ListenAndServe("127.0.0.1:8080", nil); err != nil {
		fmt.Println("Server error:", err)
	}
}

です。

static/index.htmlは

<!doctype html>
<html lang="ja">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Laragon Go Environment Check</title>

    <style>
      body {
        max-width: 720px;
        margin: 40px auto;
        padding: 0 20px;
        font-family: Arial, sans-serif;
        line-height: 1.6;
      }

      #status {
        margin-top: 24px;
        padding: 20px;
        border: 1px solid #d1d5db;
        border-radius: 12px;
        background-color: #f8fcfc;
      }

      #status strong {
        display: inline-block;
        width: 120px;
      }
    </style>
  </head>

  <body>
    <h1>Laragon Go Environment Check</h1>

    <div id="status">
      <p>APIデータを読み込み中です...</p>
    </div>

    <script>
      async function loadStatus() {
        try {
          const response = await fetch("/api/status");

          if (!response.ok) {
            throw new Error(`HTTP error: ${response.status}`);
          }

          const data = await response.json();
          const statusElement = document.getElementById("status");

          statusElement.innerHTML = `
            <h2>Environment Status</h2>
            <p><strong>API Status:</strong> ${data.status}</p>
            <p><strong>Language:</strong> ${data.language}</p>
            <p><strong>Go Version:</strong> ${data.goVersion}</p>
            <p><strong>OS:</strong> ${data.os}</p>
            <p><strong>Architecture:</strong> ${data.architecture}</p>
          `;
        } catch (error) {
          console.error("API ERROR:", error);

          document.getElementById("status").innerHTML = `
            <h2>Environment Status</h2>
            <p><strong>API Status:</strong> Error</p>
            <p>APIデータの取得に失敗しました。コンソールを確認してください。</p>
            <p id="api-error-detail"></p>
          `;

          document.getElementById("api-error-detail").textContent =
            `API ERROR: ${error}`;
        }
      }

      loadStatus();
    </script>
  </body>
</html>

<!doctype html>
<html lang="ja">
  <head>
    <meta charset="UTF-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1.0" />
    <title>Laragon Go Environment Check</title>

    <style>
      body {
        max-width: 720px;
        margin: 40px auto;
        padding: 0 20px;
        font-family: Arial, sans-serif;
        line-height: 1.6;
      }

      #status {
        margin-top: 24px;
        padding: 20px;
        border: 1px solid #d1d5db;
        border-radius: 12px;
        background-color: #f8fcfc;
      }

      #status strong {
        display: inline-block;
        width: 120px;
      }
    </style>
  </head>

  <body>
    <h1>Laragon Go Environment Check</h1>

    <div id="status">
      <p>APIデータを読み込み中です...</p>
    </div>

    <script>
      async function loadStatus() {
        try {
          const response = await fetch("/api/status");

          if (!response.ok) {
            throw new Error(`HTTP error: ${response.status}`);
          }

          const data = await response.json();
          const statusElement = document.getElementById("status");

          statusElement.innerHTML = `
            <h2>Environment Status</h2>
            <p><strong>API Status:</strong> ${data.status}</p>
            <p><strong>Language:</strong> ${data.language}</p>
            <p><strong>Go Version:</strong> ${data.goVersion}</p>
            <p><strong>OS:</strong> ${data.os}</p>
            <p><strong>Architecture:</strong> ${data.architecture}</p>
          `;
        } catch (error) {
          console.error("API ERROR:", error);

          document.getElementById("status").innerHTML = `
            <h2>Environment Status</h2>
            <p><strong>API Status:</strong> Error</p>
            <p>APIデータの取得に失敗しました。コンソールを確認してください。</p>
            <p id="api-error-detail"></p>
          `;

          document.getElementById("api-error-detail").textContent =
            `API ERROR: ${error}`;
        }
      }

      loadStatus();
    </script>
  </body>
</html>

です。

ブラウザで、

http://127.0.0.1:8080/

を開くと、JavaScriptが/api/statusへアクセスし、JSONを取得します。

取得した値をDOMへ反映すると、次の画面になりました。

エラー処理も確認する

正常に動くだけではなく、失敗した場合の処理も確認します。

今回はJavaScript側を、

async / await
+
try...catch

で構成しました。

さらに重要なのがresponse.okです。

fetch()は404や500などのHTTPエラーステータスを受け取っても、それだけではcatchへ移動しません。そのため、response.okを確認し、必要に応じて自分でエラーをthrowします。

そのため、

if (!response.ok) {
    throw new Error(`HTTP error: ${response.status}`);
}

のようにHTTPステータスを確認しています。

404を発生させて確認する

一時的にAPIのURLを存在しないものへ変更します。

通常：

const response = await fetch("/api/status");

const response = await fetch("/api/status");

404テスト時のみ：

const response = await fetch("/api/not-found");

const response = await fetch("/api/not-found");

すると404を検出し、画面側へエラーを表示できました。

確認後は必ず、

/api/status

へ戻します。

try...catch

if err != nil

存在しないURLでHTMLが返らないようにする

今回、実装途中では/api/not-foundへアクセスしたとき、JSONではなくindex.htmlが返ってしまうことがありました。

理由は、"/"のハンドラーが、より具体的なパターンに一致しないパスも受け取るためです。

そこで最終コードでは、

if r.URL.Path != "/" {
    http.NotFound(w, r)
    return
}

を追加しています。

これにより、存在しないパスでは正しく404を返せます。

GET以外は405 Method Not Allowedにする

/api/statusは、環境情報を取得するAPIです。

今回はGETだけを許可するようにしています。

最終版main.goでは、

if r.Method != http.MethodGet {
    w.Header().Set("Allow", http.MethodGet)
    http.Error(w, "Method Not Allowed", http.StatusMethodNotAllowed)
    return
}

を入れています。

PowerShellではcurl.exeを使って確認できます。

GET：

curl.exe -i http://127.0.0.1:8080/api/status

curl.exe -i http://127.0.0.1:8080/api/status

POST：

curl.exe -i -X POST http://127.0.0.1:8080/api/status

curl.exe -i -X POST http://127.0.0.1:8080/api/status

GETの場合は、

HTTP/1.1 200 OK

になります。

POSTの場合は、

HTTP/1.1 405 Method Not Allowed
Allow: GET

となります。

8080番ポートが使用中で起動できない場合

Go Webサーバーを試している途中で、次のエラーにも遭遇しました。

listen tcp 127.0.0.1:8080: bind:
Only one usage of each socket address
(protocol/network address/port) is normally permitted.

通常はGoサーバーを実行しているターミナルで、

Ctrl + C

を押して停止します。

それでも8080番ポートが残っている場合は、PowerShellで確認できます。

まず確認：

Get-NetTCPConnection -LocalPort 8080 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess

Get-NetTCPConnection -LocalPort 8080 -State Listen |
Select-Object LocalAddress, LocalPort, OwningProcess

表示されたPIDを確認します

Get-Process -Id <PID>

Get-Process -Id <PID>

laragon-go-testであることを確認したうえで、必要な場合だけ停止します。

Stop-Process -Id <PID>

Stop-Process -Id <PID>

最後に再確認します。

Get-NetTCPConnection -LocalPort 8080 -State Listen

Get-NetTCPConnection -LocalPort 8080 -State Listen

リスナーが存在しなければ、

No matching MSFT_NetTCPConnection objects found

No matching MSFT_NetTCPConnection objects found

今回の実機検証でも、残っていたプロセスがlaragon-go-testであることを確認してから停止しました。

VS CodeとDelveでGoをデバッグする

最後にVS CodeのGoデバッガを確認します。

Go拡張から利用できるDelveを使うと、プログラムを途中で停止し、変数の内容などを確認できます。

Go: Launch packageを追加する

VS Codeの「実行とデバッグ」で構成を追加し、

Go: Launch package

を選択します。

生成されたlaunch.jsonは

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Package",
      "type": "go",
      "request": "launch",
      "mode": "auto",
      "program": "${workspaceFolder}"
    }
  ]
}

{
  "version": "0.2.0",
  "configurations": [
    {
      "name": "Launch Package",
      "type": "go",
      "request": "launch",
      "mode": "auto",
      "program": "${workspaceFolder}"
    }
  ]
}

です。

ブレークポイントでAPI処理を停止する

/api/statusの処理内にブレークポイントを設定します。

今回は、

w.Header().Set("Content-Type", "application/json; charset=utf-8")

の行で停止させました。

ブラウザから、

http://127.0.0.1:8080/api/status

へアクセスすると、JSONがすぐに返らず、VS Code側で処理が停止します。

これは正常です。

GoがAPIレスポンスを返す途中で止まっているため、ブラウザ側は処理の再開を待っています。

Localsでstatusの値を確認する

停止中にVS Codeの「変数」からLocalsを開き、statusを展開しました。

すると、

Status        = "success"
Language      = "Go"
GoVersion     = "go1.27.1"
OS            = "windows"
Architecture  = "amd64"

を確認できました。

status := Status{

could not find statement
please use a line with a statement

w.Header().Set(...)

Goで初学者が引っかかりやすかったポイント

今回、実際にコードを書きながらいくつかGoらしいルールも確認できました。

特に:=はGoを始めたときに頻繁に目にします。

たとえば、

status := Status{}

は、statusという変数を宣言しながらStatus{}を代入しています。

ただし:=はどこでも使えるものではなく、関数内で使う構文です。

パッケージレベルではvarなどを使います。

最終的なプロジェクト構成を確認する

今回の検証を終えた時点では、プロジェクトは次の構成になりました。

laragon-go-test
│  go.mod
│  laragon-go-test.exe
│  main.go
│
├─.vscode
│      launch.json
│      settings.json
│
└─static
        index.html

laragon-go-test
│  go.mod
│  laragon-go-test.exe
│  main.go
│
├─.vscode
│      launch.json
│      settings.json
│
└─static
        index.html

launch.jsonはVS Codeのデバッグ設定です。

static/index.htmlはブラウザへ表示するHTMLです。

main.goではWebサーバー・JSON API・HTML配信を担当しています。

最終版をEXEへビルドする

最後に、Web APIまで実装した現在のコードから、改めてEXEを生成しました。

go build -o laragon-go-test.exe .

go build -o laragon-go-test.exe .

実行:

.\laragon-go-test.exe

.\laragon-go-test.exe

ブラウザ：

http://127.0.0.1:8080/

http://127.0.0.1:8080/

今回の確認では、

Laragon Go Environment Check

と表示されたあと、ブラウザから、

http://127.0.0.1:8080/

へアクセスし、最終画面が正常に表示されました。

http.ServeFile(w, r, "static/index.html")

C:\laragon\www\laragon-go-test

LaragonへGoを追加してWeb APIまで動かせた

今回は、Go 1.27.1を公式ZIPからLaragonへ手動追加し、バージョン切り替えからWeb API・VS Codeデバッグまで確認しました。

単に、

go version

が表示されるだけではなく、

Goを追加する
↓
Laragonで切り替える
↓
Go Modulesを作る
↓
Goコードを実行する
↓
Web APIを作る
↓
JavaScriptからAPIを呼び出す
↓
エラーを確認する
↓
Delveで内部の値を見る
↓
EXEへビルドする

ところまで実際に動かせています。

Goは、Web APIやCLIツール、バックエンド開発などにも利用できます。

今回のようにLaragon内でGoのバージョンを管理できるようにしておくと、他の開発環境と並べながらGoを試しやすくなります。

前の記事

LaragonでPythonを追加・切り替え、pip・venv・Flask・VS Codeまで確認する流れも紹介

Laragon番外編6｜Pythonを追加・切り替える｜pip・venv・Flask・VS Codeまで確認

Laragon番外編の流れへ戻る

Laragon番外編を最初から確認したい場合は、番外編1で複数バージョンを追加・切り替える基本的な仕組みから確認できます。

Laragon番外編1｜複数バージョンを追加・切り替える仕組みを理解する

Laragon番外編1｜複数バージョンを追加・切り替える仕組みを理解する

次に読む

次は、LaragonへJDKを追加してJava開発環境を整えます。JDKのバージョン切り替えから、java・javacによる確認、Javaプログラムのコンパイル・実行、VS Codeでの開発まで実機で確認していきます。

Ruby｜Laragon番外編8｜Rubyを追加・切り替える

記事を取得できませんでした

toshi

フルスタックエンジニア

XFacebookInstagramContact

C型肝炎や感染症の闘病を経て現在通院中
フリーランスとして今日を生きる、それがすべて。
静かな光の中で、歩みを止めずに生きていく。
実験大好きなので色々とやっていきます。