...
Eroare Git · Repository, staging și commit

fatal: ../Descarcari/logo.svg: '../Descarcari/logo.svg' is outside repository at '/home/elev/proiect'

Pe scurt

Î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

Greșit
BASH
git add ~/Descarcari/logo.svg
Corect
BASH
cp ~/Descarcari/logo.svg img/
git add img/logo.svg

Doar fișierele din folderul proiectului pot fi urmărite. Copia din img/ face parte din repository.

2Ești într-un subproiect cu propriul repository

Greșit
BASH
cd ~/proiect/frontend   # are propriul .git
git add ../README.md
Corect
BASH
git rev-parse --show-toplevel
cd ~/proiect
git add README.md

Rădăcina repository-ului e folderul cu .git cel mai apropiat. Verifică-l și rulează comanda din repository-ul potrivit.

Repară tu

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.

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

← Toate erorile Git

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ță 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.