fatal: ../Descarcari/logo.svg: '../Descarcari/logo.svg' is outside repository at '/home/elev/proiect'
Încerci să adaugi în Git un fișier aflat în afara folderului proiectului. Git urmărește doar ce e în repository: copiază sau mută fișierul în proiect (de exemplu cp ~/Descarcari/logo.svg img/) și adaugă copia.
Explicat de Tudor Andrei Dumitrescu, Senior Software Developer, fondatorul Academiei ProgramatorilorActualizat la
Ce înseamnă
Un repository cuprinde doar folderul în care ai rulat git init (cel cu .git) și subfolderele lui. Când dai lui git add o cale care iese din acest folder (cu ../ sau o cale absolută spre alt loc), Git nu are unde să o pună în index și se oprește: fatal: <cale>: '<cale>' is outside repository at '/home/elev/proiect'. Partea de la final îți arată rădăcina repository-ului curent.
Mesajul apare când vrei să adaugi direct un fișier descărcat, o imagine de pe Desktop sau un fișier dintr-un proiect vecin. Soluția e să aduci fișierul în proiect, cu cp sau mv, la locul unde trebuie să stea, și să adaugi acea cale. Mai rar, mesajul înseamnă că repository-ul e în alt loc decât crezi (de exemplu ai deschis terminalul într-un subproiect cu propriul .git): git rev-parse --show-toplevel îți arată rădăcina.
De ce apare: cauzele frecvente
1Adaugi un fișier descărcat, direct din Descărcări
git add ~/Descarcari/logo.svgcp ~/Descarcari/logo.svg img/
git add img/logo.svgDoar fișierele din folderul proiectului pot fi urmărite. Copia din img/ face parte din repository.
2Ești într-un subproiect cu propriul repository
cd ~/proiect/frontend # are propriul .git
git add ../README.mdgit rev-parse --show-toplevel
cd ~/proiect
git add README.mdRădăcina repository-ului e folderul cu .git cel mai apropiat. Verifică-l și rulează comanda din repository-ul potrivit.
Repară eroarea, direct în pagină
Ai descărcat logo-ul site-ului în ~/Descarcari/logo.svg. Din proiect (~/proiect), git add ../Descarcari/logo.svg dă is outside repository at '/home/elev/proiect'. Pune logo-ul în proiect, în folderul img/, și salvează-l într-un commit cu mesajul Adaug logo.
Indiciu
Fișierul trebuie să ajungă întâi în folderul proiectului.
Reparația
Vezi eroarea:
git add ../Descarcari/logo.svgCopiază fișierul în proiect și adaugă copia:
mkdir -p img
cp ~/Descarcari/logo.svg img/
git add img/logo.svg
git commit -m "Adaug logo"Rezultat: img/logo.svg este în ultimul commit.
De ce merge
Git urmărește doar fișierele de sub rădăcina repository-ului, /home/elev/proiect. Fișierul din Descărcări era în afara ei, deci nu putea intra în index. După ce îl copiezi în img/, calea img/logo.svg face parte din proiect, iar git add și git commit funcționează obișnuit. Pe orice alt calculator, clona proiectului va avea logo-ul.
Alte forme ale mesajului
fatal: /home/elev/Desktop/poza.png: '/home/elev/Desktop/poza.png' is outside repository at '/home/elev/proiect'fatal: '../altul/b.txt' is outside repository
Cum o eviți pe viitor
- Păstrează toate resursele proiectului (imagini, fonturi, date) în folderul lui, într-o structură clară (
img/,assets/). - Când descarci ceva pentru proiect, salvează-l direct în folderul proiectului.
- Dacă nu știi unde e rădăcina, rulează
git rev-parse --show-toplevel. - Când lucrezi cu mai multe proiecte, deschide câte un terminal în folderul fiecăruia.
Întrebări frecvente
Pot face Git să urmărească un fișier din alt folder, fără să-l copiez?
Nu direct. Un link simbolic (ln -s) e urmărit ca link, nu ca fișierul spre care arată, deci pe alt calculator nu va funcționa. Copiază fișierul în proiect.
Ce face git rev-parse --show-toplevel?
Afișează calea absolută a rădăcinii repository-ului în care te afli, adică folderul care conține .git.
Erori înrudite
fatal: pathspec 'stil.css' did not match any files git add nu găsește niciun fișier cu numele sau calea pe care ai scris-o. Verifică numele exact cu ls sau git status (inclusiv folderul și literele mari) și rulează git add cu calea corectă, de exemplu git add css/stil.css. fatal: not a git repository (or any of the parent directories): .git Git nu găsește niciun repository în folderul curent și nici în folderele de deasupra lui. Fie ești în folderul greșit (verifică cu pwd și mergi cu cd în proiect), fie proiectul nu a fost inițializat încă și trebuie să rulezi git init. warning: adding embedded git repository: frontend Folderul pe care îl adaugi are propriul .git, deci e un repository în repository. Git salvează doar o referință spre el, nu fișierele. Dacă voiai un singur proiect, șterge frontend/.git, apoi git rm --cached frontend și git add frontend din nou. Învață Git de la zero, cu exerciții la fiecare lecție
Curs Git: lecții scurte, fiecare cu un exercițiu verificat automat, direct în browser. Primele 15 lecții sunt gratuite.
