[MacOS] IntelliJ와 Git 연동할 때 여러 문제와 해결, 팁들

맥북 사용자 IntelliJ와 Git 연동하기

IntelliJ IDEA와 GitHub는 개발자들이 효율적으로 협업할 수 있는 좋은 도구 조합입니다.

하지만 처음 설정하거나 작업 중 문제가 발생하면 막막할 수 있습니다.

이번 글에서는 IntelliJ와 Git을 연동하면서 발생할 수 있는 다양한 문제와 그 해결 방법을 정리했습니다.

특히 맥북 사용자에게 초점을 맞췄습니다.

---

1. IntelliJ와 Git 연동 준비

문제: git 명령어를 찾을 수 없음

현상

IntelliJ에서 Git을 설정하려고 하면 다음과 같은 에러가 나타납니다:

• Cannot find git executable
• 터미널에서도 git 명령어가 인식되지 않음.

원인

• Git이 맥북에 설치되어 있지 않거나, 설치는 되어 있지만 시스템 경로(PATH)에 등록되지 않았습니다.

해결 방법

Git 설치 여부 확인:

git --version

• 설치되어 있지 않다면 Homebrew를 사용해 설치합니다:

brew install git

 

 

IntelliJ에서 Git 설정:

• Preferences > Version Control > Git로 이동합니다.
• Git executable 경로를 확인하거나 자동 탐색 기능을 사용해 설정합니다.
• "Test" 버튼을 눌러 Git이 제대로 동작하는지 확인합니다.

---

2. GitHub와 IntelliJ 연동

문제: GitHub 계정 연동 실패

현상

• IntelliJ에서 GitHub 계정을 추가하려 하면 인증이 실패하거나 Personal Access Token을 요구합니다.

원인

• 최근 GitHub의 보안 정책 변경으로 인해 기본 암호 인증이 중단되었습니다. 대신 Personal Access Token을 사용해야 합니다.

해결 방법

1. GitHub에서 Personal Access Token 생성:
   • GitHub 계정에서 Settings > Developer Settings > Personal Access Tokens로 이동합니다.
   • 새 토큰을 생성하고 필요한 권한(repo, read:org)을 선택합니다.
2. IntelliJ에 GitHub 계정 추가:
   • Preferences > Version Control > GitHub로 이동합니다.
   • "+" 버튼을 눌러 계정을 추가합니다.
   • Personal Access Token을 입력하여 연동합니다.

---

3. IntelliJ 프로젝트를 GitHub에 업로드

문제: 이미 있는 IntelliJ 프로젝트를 새 GitHub 리포지토리에 업로드

현상

IntelliJ에서 만든 기존 프로젝트를 GitHub의 새 리포지토리에 업로드하려면 어떤 단계를 거쳐야 할지 모르겠음.

해결 방법

Git 초기화:

 

git init

 

IntelliJ에서 Git 활성화:

• VCS > Enable Version Control Integration을 선택하고 Git을 활성화합니다.

원격 리포지토리 연결:

git remote add origin https://github.com/username/repository.git

 

파일 추가 및 커밋:

git add .
git commit -m "Initial commit"

 

푸시:

git push -u origin main

---

4. 푸시 에러: Remote Rejected

문제: git push 시 "rejected" 에러 발생

현상

error: failed to push some refs to 'https://github.com/username/repository.git'
hint: Updates were rejected because the remote contains work that you do
hint: not have locally.

원인

원격 리포지토리에 이미 초기화된 내용이 있어, 로컬 커밋과 충돌이 발생했습니다.

해결 방법

원격 리포지토리의 최신 변경 사항 가져오기:

git pull origin main --rebase

 

변경 사항 푸시:

git push -u origin main

 

만약 원격의 변경 사항을 무시하고 로컬 파일만 덮어쓰려면:

⚠️ 주의: 이 명령어는 원격 변경 사항을 완전히 덮어쓰므로 팀 작업 시 신중히 사용해야 합니다.

git push -u origin main --force

---

5. IntelliJ와 Git 동기화 관련 팁

브랜치 관리

• IntelliJ 하단의 Git 탭을 사용해 브랜치를 생성하거나 전환하세요.
• 새 브랜치를 만든 후 푸시하려면 다음 명령어를 사용합니다:

git push -u origin <branch-name>

Pull & Push 간소화

• git pull origin main --rebase 명령어를 사용해 로컬 커밋과 원격 변경 사항을 깔끔히 정리하세요.
• git push만으로 작업을 푸시하려면 -u 옵션으로 업스트림 브랜치를 설정합니다:

git push -u origin main

 

---

결론

IntelliJ와 Git, GitHub를 연동하는 과정에서 발생할 수 있는 문제를 차근차근 해결하는 방법을 알아보았습니다.

맥북 환경에서 Git을 처음 설정하거나 원격 리포지토리와의 충돌 문제를 해결하는 과정은 복잡할 수 있지만, 위 단계를 따라가면 문제를 손쉽게 해결할 수 있을 것입니다.