GoLand 2026.1 Help

ファイルの埋め込み

Go 1.16 から、Go バイナリにファイルを埋め込むことができます。 これは、ハードドライブから必要なすべてのファイルがすでに含まれているバイナリをビルドしてユーザーに提供できることを意味します。 別々に提供して、コンピューターの特定の場所に配置する必要はありません。 また、次にバイナリを別のディレクトリに移動するときに、これらのファイルへのパスを更新する必要はありません。

さらに、次の使用箇所を検討してください。

  • Go テンプレートの操作中にテンプレートファイルを埋め込むことができます

  • HTML、CSS、JavaScript ファイルを Go サーバーバイナリと一緒に提供する

  • データベース移行スクリプトをバイナリで提供する

ファイルを埋め込むには、 //go:embed ディレクティブを使用して、埋め込む 1 つまたは複数のファイルを指定する必要があります。 これらの変数は、パッケージの最上位で宣言する必要があります。 これは、関数本体にこれらの変数を含めることができないことを意味します。

次のタイプを埋め込むことができます: 文字列[]byteembed.FS

ディレクトリを埋め込む場合、ドット( )またはアンダースコア(_ )で始まるすべてのファイルが除外されます。 含めるには、 all 接頭辞を使用する必要があります。 例: all:webapp には「webapp/.tempfile」と「webapp/dir/.tempfile」が埋め込まれています。

Go にファイルを埋め込む

コード補完

  • 自動補完を使用するか、 Ctrl+Space を押すと、ファイルとディレクトリの名前を補完できます。

    code_completion_for_embed_directive
  • 参照から対応するファイルに移動するには、 Ctrl+B を押します。

ファイルとディレクトリの名前を変更する

  • ファイル名をクリックして、 リファクタリング | 名前の変更 に移動します。

    ファイルとディレクトリの名前を変更する

ファイルの使用箇所を見つける

  • ファイル名をクリックして、 編集 | 使用箇所の検索 | 使用箇所の検索 を選択します。

    ファイルの使用箇所を見つける

インスペクションを使う

IDE は、次の状況で警告を表示します。

  • 存在しないファイルまたはフォルダーを参照します。

    存在しないフォルダー
  • 構造体タイプまたはその他のサポートされていないタイプにファイルを埋め込もうとしました。

  • embed パッケージを インポート リストに追加するのを忘れました。

    埋め込みパッケージがありません
2026 年 5 月 22 日