...
Eroare Go · Variabile, importuri și nume

undefined: strings.toUpper (but have ToUpper)

Pe scurt

Ai scris numele unei funcții din alt pachet cu literă mică. În Go, doar numele care încep cu majusculă sunt exportate: strings.ToUpper, strconv.Itoa, json.Marshal. Compilatorul îți arată chiar numele corect în paranteză.

Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la

Ce înseamnă

În Go nu există cuvinte cheie public sau private. Un nume este vizibil din afara pachetului doar dacă începe cu literă mare (este exportat). Așa că strings.toUpper nu poate fi folosit din main, chiar dacă ar exista în interiorul pachetului.

Mesajul are două părți: undefined: strings.toUpper spune că numele nu e accesibil, iar (but have ToUpper) îți dă varianta exportată, cu majusculă. În versiunile mai vechi de Go mesajul era cannot refer to unexported name strings.toUpper.

Aceeași regulă se aplică și pachetelor tale: o funcție calculeazaTotal din pachetul facturi nu poate fi apelată din main ca facturi.calculeazaTotal; trebuie redenumită CalculeazaTotal. La câmpurile de struct și la JSON regula e aceeași.

De ce apare: cauzele frecvente

1Funcție standard scrisă cu literă mică

Greșit
GO
fmt.println("Salut")
s := strconv.itoa(42)
Corect
GO
fmt.Println("Salut")
s := strconv.Itoa(42)

Toate funcțiile publice ale bibliotecii standard încep cu majusculă.

2Funcție din pachetul tău, neexportată

Greșit
GO
// facturi/facturi.go
func calculeazaTotal(p []float64) float64 { ... }

// main.go
t := facturi.calculeazaTotal(preturi)
Corect
GO
// facturi/facturi.go
func CalculeazaTotal(p []float64) float64 { ... }

// main.go
t := facturi.CalculeazaTotal(preturi)

Pentru a fi folosită din alt pachet, funcția trebuie să înceapă cu literă mare.

3Copiat din alt limbaj (camelCase)

Greșit
GO
n := strings.split(linie, ",")
Corect
GO
n := strings.Split(linie, ",")

În Go, majuscula de la început face parte din nume și decide vizibilitatea.

Repară tu

Repară eroarea, direct în pagină

Programul trebuie să afișeze codul unui produs în majuscule, dar funcția din strings e scrisă cu literă mică și compilarea se oprește cu undefined: strings.toUpper (but have ToUpper). Repară apelul ca programul să afișeze Cod: ABC-123.

Codul care dă eroarea
GO
package main

import (
	"fmt"
	"strings"
)

func main() {
	cod := "abc-123"
	fmt.Println("Cod:", strings.toUpper(cod))
}
După reparație, programul afișează
Cod: ABC-123
Indiciu

Funcțiile exportate din pachetele Go încep cu majusculă.

Alte forme ale mesajului

  • cannot refer to unexported name strings.toUpper
  • undefined: fmt.println (but have Println)
  • name toUpper not exported by package strings

Cum o eviți pe viitor

Folosește completarea automată a editorului după punct (strings.): îți arată doar ce e exportat. Când scrii propriile pachete, decide conștient ce exporți: numele cu majusculă devin API-ul pachetului, restul rămân detalii interne. Dacă un câmp de struct trebuie să ajungă în JSON, și el trebuie să înceapă cu majusculă.

Întrebări frecvente

De ce Go decide vizibilitatea după prima literă?

Ca să vezi direct din nume, oriunde în cod, dacă ceva e public sau privat, fără să cauți declarația.

Pot folosi litere mici în interiorul aceluiași pachet?

Da. Numele neexportate se pot folosi liber în toate fișierele aceluiași pachet; restricția e doar între pachete.

Erori înrudite

← Toate erorile Go

Tudor Andrei Dumitrescu
Cine a explicat eroarea

Tudor Andrei Dumitrescu

Senior Software Developer · fondatorul Academiei Programatorilor

LinkedIn
  1. 2019 Junior JavaCognizant Softvision
  2. 2021 Mid JavaCognizant Softvision
  3. 2022 Team LeaderEndava
  4. 2023 Senior Software DeveloperUniCredit
  5. Acum Senior Software DeveloperHCLTech
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu
Certificat de formator autorizatMinisterul Muncii și Ministerul Educației · 2022
Certificat de absolvire Instructor / Preparator formare, Tudor Andrei Dumitrescu

Certificat de formator autorizat · Ministerul Muncii și Ministerul Educației · 2022

Din 2020 construiește Academia Programatorilor, iar din 2026 și JoburiIT.ro. Fiecare eroare de aici a fost reprodusă în editorul nostru: codul greșit chiar dă mesajul din titlu, iar reparația chiar funcționează.

Învață Go de la zero, cu exerciții la fiecare lecție

Curs Go: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.