Go Academy · Lektion

Cobra-Grundlagen

Root-Command, Run, Args und Hilfegenerierung

Lektion 1 von 413 Schritte

Cobra-Grundlagen ist eine kostenlose Go Academy-Lektion auf CoddyKit. Dies ist Lektion 1 von 4. Du kannst die komplette Lektion unten kostenlos lesen – dann übst du sie direkt im Browser mit einem integrierten Code-Editor und einem KI-Tutor rund um die Uhr. Sie ist Teil des Go Academy-Lernpfads, und dein Fortschritt wird über Web und CoddyKit-App synchronisiert. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.

Was ist Cobra?

Cobra ist die beliebteste Go-Bibliothek zum Erstellen von CLI-Anwendungen. Sie bietet Befehle, Flags, Unterbefehle, Hilfegenerierung, Shell-Vervollständigung und Argumentvalidierung.

Cobra installieren

Fügen Sie cobra als Abhängigkeit hinzu und verwenden Sie optional den CLI-Generator:

go get github.com/spf13/cobra
// Optional: cobra-cli for scaffolding
go install github.com/spf13/cobra-cli@latest
cobra-cli init myapp

Root-Befehl

Jede Cobra-Anwendung verfügt über einen Root-Befehl. Definieren Sie ihn mit Use, einer Short-Beschreibung und einer Run-Funktion:

var rootCmd = &cobra.Command{
    Use:   "myapp",
    Short: "My awesome CLI",
    Run: func(cmd *cobra.Command, args []string) {
        fmt.Println("Hello from root!")
    },
}
func main() { rootCmd.Execute() }

cobra.Command-Struktur

Wichtige Felder: Use (Befehlsname und Kurzbeschreibung), Short (einzeilige Beschreibung), Long (detaillierte Hilfe), Run (führt den Befehl aus), RunE (gibt einen Fehler zurück).

RunE zur Fehlerweitergabe

Verwenden Sie RunE statt Run, um Fehler zurückzugeben. Cobra gibt den Fehler automatisch aus und beendet sich mit einem Exit-Code ungleich null.

var rootCmd = &cobra.Command{
    RunE: func(cmd *cobra.Command, args []string) error {
        return doWork()
    },
}

Unterbefehle hinzufügen

Erstellen Sie Unterbefehle als separate cobra.Command-Werte und fügen Sie sie mit AddCommand zum Root-Befehl hinzu:

var serveCmd = &cobra.Command{
    Use:   "serve",
    Short: "Start the server",
    RunE:  runServe,
}
func init() { rootCmd.AddCommand(serveCmd) }

Cobra-Projektstruktur

Üblicher Aufbau: ein Verzeichnis cmd/ mit einer Datei pro Unterbefehl sowie root.go. main.go ruft nur cmd.Execute() auf.

cmd/
  root.go    // rootCmd definition
  serve.go   // serveCmd
  migrate.go // migrateCmd
main.go

Argumentvalidierung

Verwenden Sie integrierte Validatoren wie cobra.ExactArgs und MinimumNArgs oder eine eigene ValidArgsFunction:

var cmd = &cobra.Command{
    Args: cobra.ExactArgs(2),
    RunE: func(cmd *cobra.Command, args []string) error {
        fmt.Println(args[0], args[1])
        return nil
    },
}

Automatisch generierte Hilfe

Cobra generiert automatisch --help / -h für jeden Befehl sowie einen help-Unterbefehl. Der Text stammt aus Use, Short, Long und den Flags.

Shell-Vervollständigung

Cobra generiert standardmäßig Vervollständigungsskripte für bash, zsh, fish und PowerShell über rootCmd.GenBashCompletion oder den integrierten completion-Unterbefehl.

Viper-Integration

Kombinieren Sie Cobra mit Viper zur Konfigurationsverwaltung: Mit Cobra definierte Flags werden an Viper-Schlüssel gebunden, sodass Werte aus Flags, Umgebungsvariablen oder Konfigurationsdateien stammen können.

Kurzer Test

Was ist der Unterschied zwischen cobra.Command.Run und RunE?

Beantworte es in der interaktiven Lektion

Zusammenfassung: Cobra-Grundlagen

Wichtige Punkte:

cobra.Command mit Use/Short/RunE ist der zentrale Baustein
rootCmd.AddCommand(subCmd) für hierarchische Befehle
cobra.ExactArgs/MinimumNArgs zur Argumentvalidierung
Hilfe und Vervollständigung werden automatisch generiert

Kostenlos starten

Lerne Go mit einem KI-Tutor — kostenlos

Schreibe und führe echten Code in deinem Browser aus, bekomme sofortige Hilfe von einem 24/7 KI-Tutor und setze dein Lernen im Web oder in der App fort.

Kurse: 51
Lektionen: 203

Kostenlos lernen Den vollständigen Kurs ansehen

Häufig gestellte Fragen

Ist die Lektion „Cobra-Grundlagen“ kostenlos?

Ja — der vollständige Text von „Cobra-Grundlagen“ ist hier im Web kostenlos zu lesen. Um sie interaktiv zu üben (integrierter Code-Editor und 24/7 KI-Tutor) und den Rest des Go Academy-Kurses freizuschalten, upgrade auf CoddyKit PRO. Der Go Academy-Kurs umfasst insgesamt 4 Lektionen.

Was lerne ich in „Cobra-Grundlagen“?

Root-Command, Run, Args und Hilfegenerierung Du übst Go Academy mit praktischem Code, den du direkt im Browser ausführst, und ein 24/7 KI-Tutor beantwortet deine Fragen während du die Lektion bearbeitest.

Brauche ich Erfahrung, um Go Academy zu starten?

Keine Vorkenntnisse erforderlich. Go Academy auf CoddyKit ist für Anfänger bis fortgeschrittene Lernende strukturiert, sodass du hier starten oder von Anfang an beginnen und in deinem eigenen Tempo voranschreiten kannst. Dies ist Lektion 1 von 4.

Wie lange dauert die Lektion „Cobra-Grundlagen“?

Die meisten CoddyKit-Lektionen dauern etwa 5–10 Minuten. Jede ist kompakt und interaktiv, sodass du stetig Fortschritte machst und genau dort weitermachst, wo du aufgehört hast – im Web und in der App.

Kann ich in dieser Go Academy-Lektion Code schreiben und ausführen?

Ja. Jede Go Academy-Lektion enthält einen integrierten Code-Editor, sodass du echten Code direkt in deinem Browser schreibst und ausführst und sofort KI-Feedback erhältst — ohne lokale Einrichtung erforderlich.

Alle Lektionen in diesem Kurs

← Zurück zu Go Academy