PyCharm 좌측 사이드바(Project view) 파일 목록 안 보일 때

파이참(PyCharm)으로 프로젝트 진행하다보면 실제 파일은 온전히 남아있지만 프로젝트 구조 트리(좌측 사이드바)에 파일이 표시되지 않는 경우가 있다. 다른 IDE나 VIM을 통하여 프로젝트를 계속 진행할 수 있지만 기존에 사용하던 개발도구가 바뀌면 개발속도가 더뎌지게 되니 해결하는 것이 좋다.

파이참 좌측 사이드바를 보여주기 위한 예시 이미지일뿐 장애 사례가 아니다.

Cause.

나의 경우는 GitHub에 업로드한 소스파일이 로컬에서 내려받았을 때 잘 되는지 확인하기 위하여 프로젝트와 관련된 venv가 로컬 환경에서 이미 파이참으로 Activate 중일 때 다른 터미널을 따로 실행하여 Git Clone 및 venv activate 하는 과정에서 프로젝트 구조 파일이 잘못된 것이 아닌가 생각된다.

문제가 발생한 것으로 추정되는 project.iml 파일

configuration가 포함된 component가 누락되었다. templates 관련 컴포넌트도 누락되었으나 프로젝트에서 사용하지 않았으므로 문제가 될 것으로 보이진 않는다.

<?xml version="1.0" encoding="UTF-8"?>
<module type="PYTHON_MODULE" version="4">
  <component name="NewModuleRootManager">
    <content url="file://$MODULE_DIR$">
      <excludeFolder url="file://$MODULE_DIR$/env" />
    </content>
    <orderEntry type="jdk" jdkName="Python 3.7 (xxxx_project)" jdkType="Python SDK" />
    <orderEntry type="sourceFolder" forTests="false" />
  </component>
  <component name="PyDocumentationSettings">
    <option name="format" value="PLAIN" />
    <option name="myDocStringFormat" value="Plain" />
  </component>
</module>

정상화된 후에 확인한 project.iml 파일

위의 project.iml에서 누락된 component가 모두 포함된 것을 볼 수 있다.

<?xml version="1.0" encoding="UTF-8"?>
<module type="PYTHON_MODULE" version="4">
  <component name="FacetManager">
    <facet type="django" name="Django">
      <configuration>
        <option name="rootFolder" value="$MODULE_DIR$" />
        <option name="settingsModule" value="config/settings.py" />
        <option name="manageScript" value="$MODULE_DIR$/manage.py" />
        <option name="environment" value="&lt;map/&gt;" />
        <option name="doNotUseTestRunner" value="false" />
        <option name="trackFilePattern" value="migrations" />
      </configuration>
    </facet>
  </component>
  <component name="NewModuleRootManager">
    <content url="file://$MODULE_DIR$" />
    <orderEntry type="jdk" jdkName="Python 3.7 (xxxx_project)" jdkType="Python SDK" />
    <orderEntry type="sourceFolder" forTests="false" />
  </component>
  <component name="PyDocumentationSettings">
    <option name="format" value="PLAIN" />
    <option name="myDocStringFormat" value="Plain" />
  </component>
  <component name="TemplatesService">
    <option name="TEMPLATE_CONFIGURATION" value="Django" />
  </component>
</module>

Solution.

해결방법은 간단한데, 파이참과 터미널을 모두 종료하고 프로젝트 Root directory에 있는 .idea를 삭제한 뒤 다시 파이참 및 프로젝트를 열면 프로젝트 구조 트리(좌측 사이드바)에 파일이 정상적으로 표시된다.

위와 같은 방법으로 해결하기 전에 먼저 프로젝트 구조를 확인하고 만약 콘텐츠 루트가 아래 이미지처럼 비어 있는 경우 콘텐츠 루트를 먼저 추가해봐야 한다. 만약 아래 콘텐츠 루트가 등록되어 있지 않다면 “콘텐츠 루트 추가(C)”로 추가하면 된다.

• 경로: Preferences > 프로젝트 세팅(프로젝트: 프로젝트명) > 프로젝트 구조

사진처럼 콘텐츠 루트가 텅 비어있으면 콘텐츠 루트를 등록한다.