コンテンツにスキップ

Go/goコマンド/work/init

出典: フリー教科書『ウィキブックス(Wikibooks)』

go work init

[編集]

go work init とは、Go の ワークスペース機能(Go 1.18+)を初期化するコマンドです。

概要

[編集]

現在のディレクトリに go.work ファイルを作成し、複数のモジュールをまとめて扱うワークスペースを構築します。

基本的な使い方

[編集]
# 空のワークスペースを作成
go work init

# モジュールディレクトリを指定して初期化
go work init ./moduleA ./moduleB

生成される go.work の例:

go 1.26

use (
    ./moduleA
    ./moduleB
)

どんな時に使うか

[編集]
ユースケース 説明
モノレポ開発 複数モジュールを1つのリポジトリで管理
ローカル依存の開発 replace ディレクティブなしに別モジュールをローカル参照
並行開発 ライブラリとそれを使うアプリを同時に修正・テスト

go.mod との違い

[編集]
  • go.mod → 1つのモジュールを定義するファイル
  • go.work → 複数のモジュールをまとめるワークスペース定義ファイル

go.work があると、go ツールは go.mod の代わりにそちらを優先して参照します。

よく使う関連コマンド

[編集]
go work use ./newmodule   # モジュールを追加
go work sync              # 依存関係を同期
go work edit              # go.work を編集

⚠️ go.work は通常 .gitignore に追加するか、チームで共有するか、プロジェクトの方針に合わせて管理します。