---
id: 1872edeaa3c5fc09a1eba338cf2b01b1
author: wHoIsDReAmer
title: 'Go-kääntöajan muuttujien injektointi: go build -ldflags -X -käytön opas'
description: Tämä käsittelee menetelmää, jolla Go-merkkijonomuuttujien arvot injektoidaan käännösaikana ilman ulkoista .env-tiedostoa, käyttämällä go build -ldflags "-X" linker flagia ja määrittämällä paketin symbol path -polun.
language: fi
date: 2025-06-01T15:56:46.352281271Z
path: /blog/posts/compile-time-variable-injection-of-go-z5420556c
category: api
---

## Tausta

Työskennellessäni äskettäin yrityksen projektin parissa etsin tapaa injektoida muuttujia käännösajassa ilman `.env`-tiedostoa.
Ajattelin, että tämä olisi erittäin kätevää, koska silloin riittäisi yksi ainoa tiedosto ilman `.env`-tiedostoja tai useita konfiguraatiotiedostoja.

Aluksi etsin `go:generate`-CLI-työkalua, joka generoisi vakiotiedoston `.env`-tiedoston pohjalta, mutta sellaista ei löytynyt.

Toisaalta, jos asia on näin, voisi yksinkertaisesti muokata constants-tiedostoa eikä tarvitsisi vaivautua generoinnilla. Löysin kuitenkin Rustin `include_bytes!`-makron kaltaisen tavan injektoida arvoja käännösajassa.

## Käännösajan muuttujien injektointi

Käyttö on yksinkertaista.

```go
package main

import "fmt"

var Foo string

func main() {
    fmt.Println(Foo)
}
```

Jos koodi on yllä olevan kaltainen, voidaan arvo injektoida buildin yhteydessä seuraavasti.

```bash
go build -ldflags="-X 'main.Foo=bar'"
```

Kun argumentti välitetään ldflag-lipun kautta, muuttujan `Foo` arvoksi injektoituu käännösajassa arvo `bar`. Se on yksinkertaista.

Jos projektissa on useita samannimisiä paketteja tai muuttujia eri paikoissa, riittää **määrittää paketin polku**.

```go
// github.com/myproject/config/config.go
package config

var Version string

// github.com/myproject/internal/config/config.go
package config

var BuildTime string
```

Tällaisissa tapauksissa voidaan injektoida erikseen seuraavasti:

```bash
go build -ldflags="-X 'github.com/myproject/config.Version=v1.0.0' -X 'github.com/myproject/internal/config.BuildTime=2025-05-27'"
```

Myös samassa paketissa olevien useiden muuttujien kohdalla riittää, että välitetään lisää argumentteja.

```bash
go build -ldflags="-X 'main.Version=v1.0.0' -X 'main.BuildTime=2025-05-27' -X 'main.GitCommit=abc123'"
```

Ominaisuudet ovat seuraavat:

- **Muuttujan ei tarvitse olla julkinen**: myös pienellä kirjaimella alkavan muuttujan arvo voidaan injektoida.
- **Tuetaan vain string-tyyppi**: muita tyyppejä ei tueta.

## Viitteet

- [https://stackoverflow.com/questions/47509272/how-to-set-package-variable-using-ldflags-x-in-golang-build](https://stackoverflow.com/questions/47509272/how-to-set-package-variable-using-ldflags-x-in-golang-build)