[ 오류 해결 ] Mac에서 `pip install pygraphviz` 설치 문제 해결하기

Mac에서 pygraphviz를 설치하려고 할 때, 아래와 같은 오류 메시지가 발생할 수 있습니다.

이 문제는 pygraphviz가 Graphviz 라이브러리를 찾지 못해 발생합니다. 일반적으로 brew install graphviz로 Graphviz를 설치하면 해결될 것으로 기대되지만, 환경 설정이 올바르지 않으면 문제가 지속될 수 있습니다.

아래는 이 문제를 해결한 방법입니다.

---

1. 문제

pip install pygraphviz 명령을 실행하면 다음과 같은 오류가 발생합니다.

• 에러 요약:
  • Graphviz의 헤더 파일(cgraph.h)을 찾지 못함
  • 빌드 과정에서 clang 컴파일러 에러 발생

pygraphviz/graphviz_wrap.c:3023:10: fatal error: 'graphviz/cgraph.h' file not found
      #include "graphviz/cgraph.h"
               ^~~~~~~~~~~~~~~~~~~
1 warning and 1 error generated.
error: command '/usr/bin/clang' failed with exit code 1

---

2. 일반적인 해결법

먼저 brew install graphviz로 Graphviz를 설치합니다.

brew install graphviz

설치 후 다시 pip install pygraphviz를 실행했지만, 문제는 여전히 해결되지 않았습니다.

---

3. 최종 해결법

환경 변수를 수동으로 설정하고 설치를 다시 시도해야 합니다. 다음 명령어를 순서대로 실행하세요:

export PATH=$(brew --prefix graphviz):$PATH
export CFLAGS="-I $(brew --prefix graphviz)/include"
export LDFLAGS="-L $(brew --prefix graphviz)/lib"
pip install pygraphviz

명령어 설명

• PATH 설정: Graphviz 바이너리 경로를 시스템 경로에 추가합니다.
• CFLAGS: Graphviz의 include 디렉토리를 컴파일러가 참조하도록 설정합니다.
• LDFLAGS: Graphviz의 lib 디렉토리를 링커가 참조하도록 설정합니다.

---

4. 설치 성공 메시지

위 단계를 따라 실행하면 pygraphviz 설치가 성공적으로 완료됩니다.

---

참고: 설치 후에도 문제가 발생하면 python -m pip show pygraphviz로 설치 경로를 확인하고, Graphviz 라이브러리가 올바르게 연결되었는지 추가 점검하세요.