Warning: This declaration shadows an existing declaration.
Ai declarat o variabilă locală sau un parametru cu același nume ca o variabilă de stare (sau ca altă declarație). În funcție, numele se referă la cea locală, așa că variabila de stare nu se mai modifică. Redenumește variabila locală sau scoate tipul din fața ei, dacă voiai să scrii în cea de stare.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
„Shadowing” înseamnă că o declarație nouă ascunde una mai veche cu același nume. Dacă în contract ai uint256 public total; și în funcție scrii uint256 total = ...;, din acel moment total înseamnă variabila locală, care dispare la finalul funcției. Variabila de stare rămâne neschimbată.
E doar un avertisment, codul se compilează, dar aproape mereu indică un bug: ai vrut să scrii total += suma; și din obișnuință ai pus tipul în față. Apare la fel când un parametru are numele unei variabile de stare (function seteaza(uint256 pret) într-un contract cu pret) sau al unei funcții moștenite (owner, name).
Linia din avertisment e declarația care ascunde; compilatorul îți arată și unde e declarația ascunsă.
De ce apare: cauzele frecvente
1Tip pus din greșeală în fața unei atribuiri
uint256 public total;
function adauga(uint256 suma) external {
uint256 total = total + suma;
}uint256 public total;
function adauga(uint256 suma) external {
total = total + suma;
}Cu uint256 în față, linia creează o variabilă locală nouă; fără el, scrie în variabila de stare.
2Parametru cu numele variabilei de stare
uint256 public pret;
function seteazaPret(uint256 pret) external {
pret = pret;
}uint256 public pret;
function seteazaPret(uint256 pretNou) external {
pret = pretNou;
}Cu același nume, pret = pret atribuie parametrul lui însuși. Convenția des folosită este _pret sau pretNou.
Repară eroarea, direct în pagină
Contractul Casa adună încasările în total, dar după două încasări de 10 și 5 lei totalul rămâne 0, iar compilatorul arată Warning: This declaration shadows an existing declaration. Repară funcția incaseaza, ca să modifice variabila de stare. Scriptul face cele două încasări și afișează totalul.
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Casa {
uint256 public total;
function incaseaza(uint256 suma) external {
uint256 total = total + suma;
}
}Total: 15 lei
Indiciu
Linia din funcție declară o variabilă nouă din cauza tipului pus în față.
Reparația
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.20;
contract Casa {
uint256 public total;
function incaseaza(uint256 suma) external {
total = total + suma;
}
}De ce merge
Cu uint256 în față, linia crea o variabilă locală nouă numită tot total, care ascundea variabila de stare și dispărea la finalul funcției. De aceea totalul rămânea 0, iar compilatorul te avertiza. Fără tip, total = total + suma; scrie în variabila de stare, iar după cele două încasări totalul e 15.
Cum o eviți pe viitor
- Nu da variabilelor locale și parametrilor numele variabilelor de stare; folosește un prefix (
_pret) sau un alt nume (pretNou). - Nu ignora avertismentele: o consolă fără avertismente îți arată imediat unul nou.
- Scrie
uint256 x = ...doar când vrei o variabilă nouă; pentru o variabilă existentă scrie doarx = .... - Testează efectul funcției asupra stării, nu doar faptul că nu dă eroare.
Întrebări frecvente
De ce e doar avertisment, dacă e aproape mereu un bug?
Pentru că, tehnic, codul e valid: uneori chiar vrei o variabilă locală cu același nume. Compilatorul te atenționează, dar decizia îți aparține. Tratează-l ca pe o eroare.
Primesc avertismentul pentru un parametru numit owner. De ce?
Pentru că un contract moștenit (de exemplu Ownable) are deja o funcție owner(). Redenumește parametrul, de exemplu initialOwner sau _owner.
Erori înrudite
DeclarationError: Identifier already declared. Ai declarat de două ori același nume în același loc: două variabile de stare, două variabile locale sau o variabilă și o funcție cu același nume. Redenumește una dintre ele sau, dacă voiai doar o atribuire, scoate tipul din fața celei de-a doua. Warning: Unused local variable. Ai declarat o variabilă locală pe care nu o folosești nicăieri. Fie e un rest de cod care trebuie șters, fie (mai des) ai calculat ceva și ai uitat să folosești rezultatul. Folosește variabila sau șterge-o. Warning: Function state mutability can be restricted to view Avertismentul spune că funcția doar citește starea, deci poate fi marcată view. Adaugă view: pe lângă claritate, din ethers primești direct valoarea întoarsă, nu o tranzacție. Învață Solidity de la zero, cu exerciții la fiecare lecție
Curs Solidity și Smart Contracts: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
