Flutter Error 정리

Flutter를 사용하면서 발생한 에러와 해결 방법을 정리한다.

개발 중 만난 에러를 하나씩 추가하면서, 나중에 같은 문제가 발생했을 때 빠르게 확인하기 위한 기록용 글이다.

정리 방식은 다음과 같다.

에러 메시지
   |
   v
발생 상황
   |
   v
원인
   |
   v
해결 방법
   |
   v
정리

---

1. ERROR: Unable to find git in your PATH

Flutter 또는 Android Studio 터미널에서 명령어를 실행할 때 다음과 같은 오류가 발생할 수 있다.

ERROR: Unable to find git in your PATH.

이 오류는 현재 터미널이나 개발 도구가 git 명령어를 찾지 못할 때 발생한다.

즉, Git이 설치되어 있지 않거나, Git 실행 경로가 환경 변수 PATH에 등록되어 있지 않은 상태일 수 있다.

오류 의미
- Git 명령어를 찾을 수 없음
- Git이 설치되어 있지 않을 수 있음
- Git 경로가 PATH에 등록되어 있지 않을 수 있음
- Android Studio 또는 PowerShell이 Git을 인식하지 못하는 상태

발생 상황

Flutter 프로젝트에서 다음과 같은 명령어를 실행할 때 발생할 수 있다.

flutter pub get
flutter run
flutter build windows

Flutter는 일부 패키지나 SDK 정보를 가져올 때 Git을 사용할 수 있다.

그래서 Git이 제대로 인식되지 않으면 Flutter 명령어 실행 중 오류가 발생할 수 있다.

먼저 Git 설치 여부 확인하기

PowerShell 또는 Android Studio Terminal에서 다음 명령어를 실행한다.

git --version

정상적으로 설치되어 있다면 다음처럼 Git 버전이 출력된다.

git version 2.xx.x

만약 Git 버전이 출력되지 않는다면 Git 설치 또는 PATH 설정이 필요하다.

git --version 실행
   |
   v
버전 출력됨
   |
   v
Git 설치 정상

git 명령어를 찾을 수 없음
   |
   v
Git 설치 또는 PATH 설정 필요

safe.directory 설정하기

Git이 설치되어 있는데도 프로젝트 폴더 접근 권한이나 소유권 문제로 Git 관련 오류가 발생할 수 있다.

이 경우 PowerShell에서 다음 명령어를 실행할 수 있다.

git config --global --add safe.directory '*'

이 명령어의 의미는 다음과 같다.

git config
- Git 설정 변경

--global
- 현재 사용자 전체 Git 설정에 적용

--add safe.directory '*'
- 모든 폴더를 안전한 Git 작업 폴더로 허용

즉, Git이 특정 프로젝트 폴더를 안전하지 않은 디렉터리로 판단할 때 이를 허용하는 설정이다.

전체 해결 순서

오류가 발생하면 다음 순서로 확인한다.

1. PowerShell 또는 Android Studio Terminal 열기
2. git --version 실행
3. Git 버전이 나오지 않으면 Git 설치 또는 PATH 설정
4. Git은 인식되지만 safe directory 관련 오류가 나면 safe.directory 설정

명령어는 다음과 같다.

git --version

Git은 인식되지만 프로젝트 접근 관련 오류가 발생하면 다음 명령어를 실행한다.

git config --global --add safe.directory '*'

주의할 점

git config --global --add safe.directory '*' 명령어는 모든 폴더를 안전한 Git 디렉터리로 허용하는 설정이다.

개인 PC에서 개발 환경 문제를 빠르게 해결할 때는 사용할 수 있지만, 회사 PC나 보안이 중요한 환경에서는 특정 프로젝트 폴더만 등록하는 것이 더 안전하다.

특정 프로젝트만 허용하려면 다음처럼 입력할 수 있다.

git config --global --add safe.directory "C:/Users/사용자명/StudioProjects/프로젝트명"

정리하면 다음과 같다.

개인 개발 환경에서 빠르게 해결
-> git config --global --add safe.directory '*'

특정 프로젝트만 허용
-> git config --global --add safe.directory "프로젝트 경로"

정리

ERROR: Unable to find git in your PATH. 오류는 Git을 찾지 못할 때 발생한다.

먼저 Git 설치와 PATH 등록 여부를 확인해야 한다.

git --version

Git은 설치되어 있지만 프로젝트 디렉터리 권한 문제나 safe directory 문제가 발생한다면 다음 명령어를 사용할 수 있다.

git config --global --add safe.directory '*'

핵심은 다음과 같다.

git --version
- Git 설치 및 PATH 확인

git config --global --add safe.directory '*'
- Git이 프로젝트 폴더를 안전한 디렉터리로 인식하도록 설정

즉, Git 자체를 못 찾는 문제라면 Git 설치와 PATH 설정을 먼저 확인하고,
Git은 인식되는데 프로젝트 접근 문제가 발생한다면 safe.directory 설정을 추가하면 된다.