Zum Inhalt springen

Go in GitHub Actions beschleunigen

Zuletzt aktualisiert am

Um Go in GitHub Actions zu beschleunigen, verwenden Sie actions/setup-go mit dem integrierten Cache, halten GOCACHE warm, damit unveränderte Pakete nicht neu kompiliert werden, führen Pakete mit go test -p parallel aus und starten den Race Detector in einem separaten Job. Go kompiliert schnell, daher geht die meiste verlorene Zeit für das erneute Herunterladen von Modulen und das Neubauen unveränderter Teile drauf.

Dieser Leitfaden ist die Go-Version unseres allgemeinen Leitfadens für schnellere GitHub Actions.

Modul- und Build-Cache

actions/setup-go cacht standardmäßig. Laut README ist der Eingabewert cache standardmäßig true, und der Cache-Schlüssel basiert auf Ihrer Abhängigkeitsdatei (go.sum oder go.mod), sofern Sie cache-dependency-path nicht auf andere Dateien setzen (Glob-Muster sind erlaubt). Der Cache speichert sowohl den Modul-Download-Cache als auch den Go-Build-Cache, sodass bei einem Treffer sowohl go mod download als auch kompilierte Pakete wiederverwendet werden.

- uses: actions/checkout@v7
- uses: actions/setup-go@v7
  with:
    go-version-file: go.mod
    cache-dependency-path: |
      go.sum
      tools/go.sum

go-version-file liest die Version aus go.mod, go.work oder .go-version, sodass CI und Ihr Laptop synchron bleiben. Wenn Sie zusätzlich go-version setzen, hat dieser Wert Vorrang.

Cache-Einträge in GitHub Actions sind unveränderlich, und dieser Schlüssel ändert sich nur, wenn sich go.sum ändert. Das bedeutet, dass Quellcodeänderungen den Build-Cache für eine bestimmte go.sum nach dem ersten Speichern nicht aktualisieren. Bei einem großen Repository ist das eine echte Einschränkung: Der wiederhergestellte Build-Cache veraltet über Wochen. Eine Lösung ist cache: false und die eigene Verwaltung von ~/.cache/go-build mit einem Schlüssel, der den Commit und ein restore-keys-Präfix enthält:

- uses: actions/setup-go@v7
  with:
    go-version-file: go.mod
    cache: false
- uses: actions/cache@v6
  with:
    path: |
      ~/go/pkg/mod
      ~/.cache/go-build
    key: go-${{ runner.os }}-${{ hashFiles('**/go.sum') }}-${{ github.sha }}
    restore-keys: |
      go-${{ runner.os }}-${{ hashFiles('**/go.sum') }}-
      go-${{ runner.os }}-

Das erzeugt pro Commit einen neuen Eintrag, behalten Sie daher Ihr Kontingent im Blick; siehe Cache-Limits. Speichern Sie nur auf main mit actions/cache/save, wenn der Speicherplatz knapp ist, und stellen Sie überall sonst nur wieder her.

Testparallelität: -p und -parallel

Zwei verschiedene Stellschrauben:

  • go test -p N legt fest, wie viele Pakete gleichzeitig getestet werden. Standardmäßig ist es GOMAXPROCS, also die Anzahl der CPUs. Pakete laufen als separate Prozesse.
  • go test -parallel N legt fest, wie viele Tests innerhalb eines Pakets gleichzeitig laufen dürfen, aber nur Tests, die t.Parallel() aufrufen. Auch hier ist der Standard GOMAXPROCS.

Mehr Kerne beschleunigen eine Go-Suite also automatisch, wenn Sie viele Pakete haben. Liegt der Großteil Ihrer Tests in einem großen Paket ohne t.Parallel(), bringen zusätzliche Kerne für dieses Paket nichts. Fügen Sie t.Parallel() unabhängigen Tests hinzu, nie aber Tests, die sich eine Datenbankzeile oder einen globalen Zustand teilen.

Nützliche Flags in CI:

go test ./... -count=1 -shuffle=on -timeout=10m

-count=1 deaktiviert den Testergebnis-Cache von Go, was in CI für Tests, die auf die Außenwelt zugreifen, meist gewünscht ist. Sind Ihre Tests rein, lässt sich mit aktiviertem Cache und einem warmen GOCACHE die Ausführung unveränderter Pakete vollständig überspringen, was eine große Einsparung ist.

Die Kosten von -race

Der Race Detector instrumentiert Speicherzugriffe. Laut Dokumentation des Go-Race-Detectors kann er die Ausführungszeit um das 2- bis 20-Fache und den Speicherbedarf um das 5- bis 10-Fache erhöhen, eine Test-Suite mit -race ist daher oft mehrfach langsamer. Verzichten Sie nicht darauf, da er echte Fehler findet, lassen Sie ihn aber auch nicht dreimal in einer Matrix laufen.

Ein gängiger Aufbau ist ein schneller Job ohne -race für jeden Push und ein -race-Job, der parallel läuft und für das Mergen Pflicht ist:

jobs:
  test:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-go@v7
        with:
          go-version-file: go.mod
      - run: go test ./... -count=1
  race:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v7
      - uses: actions/setup-go@v7
        with:
          go-version-file: go.mod
      - run: go test ./... -race -count=1

Beide Jobs enden im Tempo des langsameren, aber die Logs des ersten liefern schnelles Feedback. Race-Builds benötigen cgo und verwenden daher eine andere Kompilierung als normale Builds und einen separaten Build-Cache; der Cache des Nicht-Race-Jobs hilft ihnen nicht.

Linting mit golangci-lint

golangci-lint kann bei großen Repositories länger dauern als die Tests. Verwenden Sie die offizielle golangci/golangci-lint-action, prüfen Sie im README die aktuellen Eingaben und Version, und führen Sie sie als eigenen Job aus, damit sie sich mit den Tests überschneidet. Die Action cacht Analyseergebnisse standardmäßig.

Einmal bauen, einmal ausliefern

Für Docker-Images kompilieren Sie mit einem Cache-Mount im Dockerfile (RUN --mount=type=cache,target=/root/.cache/go-build go build ...) und bauen mit BuildKit-Layer-Caching. Siehe Docker-Layer-Caching in CI. Cross-Compiling für mehrere Zielplattformen? Nutzen Sie eine Matrix aus GOOS/GOARCH statt Emulation, da Go nativ cross-kompiliert.

Was mehr CPU-Kerne bringen

Go nutzt alle Kerne sowohl zum Kompilieren als auch zum Testen, weshalb es sich gut für einen größeren Runner eignet. Unsere Benchmarks umfassen einen React-, Go- und Postgres-Stack mit go test -race: 6m13s auf einem GitHub-gehosteten Runner und 2m42s auf compiler.dev (2.3x), ein vollständiger CI-Lauf mit 10 Test-Shards und einer echten Datenbank, gemessen am 8. Oktober 2026. Ein Next.js-, Go-, Kafka- und Redis-Stack ging von 1m16s auf 0m44s (1.7x) zurück. Dabei handelt es sich um vollständige Pipelines, daher hängt Ihr Verhältnis davon ab, wie viel Ihrer Laufzeit auf Go-Kompilierung und -Tests entfällt.

Um einen Job auf compiler.dev umzustellen, ändern Sie runs-on: [self-hosted, Linux, compiler-ci]. Maschinengrößen und Preise finden Sie auf der Preisseite, und der Runner-Größenauswähler hilft bei der Wahl. Siehe auch die Go-Vorlage und das Test-Sharding.

FAQ

Cacht setup-go Go-Module automatisch?

Ja. Die Eingabe cache ist standardmäßig true und cacht Modul- und Build-Cache, mit dem Schlüssel aus Ihrer Abhängigkeitsdatei, sofern Sie nicht cache-dependency-path setzen.

Was ist der Unterschied zwischen go test -p und -parallel?

-p legt fest, wie viele Pakete gleichzeitig getestet werden. -parallel legt fest, wie viele t.Parallel()-Tests innerhalb eines Pakets gleichzeitig laufen. Beide Standardwerte entsprechen der CPU-Anzahl.

Wie viel langsamer ist go test -race?

Die Go-Dokumentation nennt das 2- bis 20-Fache. In der Praxis fällt der Unterschied bei Suiten mit I/O-Wartezeiten geringer aus. Führen Sie ihn in einem eigenen Job aus.

Sollte ich -count=1 in CI verwenden?

Verwenden Sie es, wenn Tests auf Datenbanken oder das Netzwerk zugreifen, damit keine gecachten Ergebnisse wiederverwendet werden. Bei reinen Unit-Tests lassen Sie den Cache aktiviert.

Diesen Go-Build auf compiler.dev ausführen Keine Karte nötig · 200 kostenlose Minuten

Kostenlos testen