본문 바로가기

IDE/IntelliJ

Git 프로젝트를 새로 열 때 Invalid VCS root mapping 오류

이 문서의 내용

    테스트 환경 및 주요 아젠다

    더보기

    이 프로젝트의 개발 환경

    • 개발 언어 및 환경
      • IntelliJ IDEA 2023.3.2 (Community Edition)
      • git version 2.39.1.windows.1

    MacOS에서 개발중인 Git 프로젝트를 Windows 환경에서 열고 진행하려고합니다.

    IntelliJ IDEA에서 프로젝트를 열자 Invalid VCS root mapping 오류가 발생합니다. 

    Problems 탭에서 해당 오류의 Configure을 클릭하면 다음과 같이 표시됩니다.

    Step 1: Directory Mappings 설정 변경

    File | Settings | Version Control | Directory Mappings에서 경고 표시된 설정을 다음과 같이 변경합니다.

    VCS의 Git을 클릭하고 <none>으로 변경합니다.

    OK 또는 Apply를 클릭하고 설정 변경을 완료합니다.

    Step 2: Git 프로젝트 Repository 재설정

    툴바의 VCS | Get from version Control에 들어갑니다.

    Repository URL에서 일치하는 소스를 선택합니다. 예제에서는 GitHub를 사용중입니다.

    GitHub 계정 또는 토큰을 사용하여 로그인합니다.

    일치하는 Remote Repository를 선택하고 Clone합니다.

    Step 3: 프로젝트 재실행

    Step 2까지의 설정을 마치면 프로젝트를 재실행하는 방법을 확인합니다.

    프로젝트가 재실행되고 Git 탭에서 Remote Repository와 정상적으로 연동된 것을 확인합니다.