Xcode 프로젝트에서 `project.pbxproj` 파일이 없을 때 해결 방법

sonny·2025년 2월 3일

TIL

목록 보기

119/133

Xcode 프로젝트를 열 때 다음과 같은 오류가 발생할 수 있다.

Project cannot be opened because it is missing its project.pbxproj file.

이 오류는 프로젝트의 핵심 파일인 project.pbxproj가 손실되었기 때문에 발생한다. 이 파일은 프로젝트의 설정을 관리하는 중요한 파일로, 없으면 프로젝트를 열 수 없다. 다음은 문제를 해결하는 다양한 방법이다.

1. 휴지통에서 복구

실수로 삭제했을 가능성이 있으므로 휴지통(Trash)을 확인하고, project.pbxproj 파일이 있다면 복구한 후 프로젝트를 다시 열어본다.

파일 경로 예시:

<프로젝트 경로>/프로젝트명.xcodeproj/project.pbxproj

2. Git을 사용하는 경우 복구

Git을 사용 중이라면, 삭제 여부를 확인하고 복구할 수 있다.

2.1 삭제 여부 확인

터미널을 열고 프로젝트 루트 디렉터리에서 실행:

cd <프로젝트 경로>
git status

만약 project.pbxproj 파일이 삭제된 것으로 표시되면 다음 명령어로 복구:

git checkout -- 프로젝트명.xcodeproj/project.pbxproj

2.2 특정 커밋에서 복구

이전 커밋에서 복구하려면 다음을 실행:

git log --oneline

이전 커밋 ID를 확인한 후:

git checkout <커밋 ID> -- 프로젝트명.xcodeproj/project.pbxproj

3. 백업에서 복구

Time Machine 또는 다른 백업이 있다면 해당 파일을 복원한다.

4. Xcode로 새 프로젝트 생성 후 비교

Xcode에서 새 프로젝트를 생성한다.
생성된 프로젝트의 project.pbxproj 파일을 기존 프로젝트와 비교한다.
필요한 설정을 반영하여 기존 프로젝트에 복구한다.

5. Xcode 재시작

Xcode를 완전히 종료하고 다시 실행한 후 프로젝트를 다시 열어본다.

killall Xcode
open <프로젝트 경로>/프로젝트명.xcodeproj

6. 프로젝트를 다시 클론 (Git 사용 시)

원격 저장소(GitHub, GitLab 등)가 있는 경우 프로젝트를 다시 클론하는 방법도 있다.

cd <저장소 경로>
rm -rf 프로젝트명  # 기존 프로젝트 삭제 (주의)
git clone <repository_url>
cd 프로젝트명
open 프로젝트명.xcodeproj

결론

project.pbxproj 파일은 Xcode 프로젝트에서 필수적인 구성 요소이므로 삭제되지 않도록 주의해야 한다. 위 방법 중 하나를 사용하여 파일을 복구한 후, 프로젝트를 다시 열어 정상적으로 작동하는지 확인하면 된다. 만약 문제가 지속되면 새로운 프로젝트를 생성하고 파일을 복사하는 방법도 고려할 수 있다.