Hugo 환경 설정 및 CLI 의존성 트러블슈팅

report_problem 문제 상황

로컬 환경에서 정적 사이트 빌드를 실행하는 과정에서 CLI 명령어를 찾을 수 없는 에러가 발생했습니다.

Error: command not found: hugo

search 원인 분석

시스템 환경 변수($PATH) 상에 Hugo 바이너리가 등록되어 있지 않거나 패키지가 설치되지 않은 상태였습니다.


build 해결 방법

macOS 패키지 관리자(Homebrew)를 통해 Hugo 확장 패키지(Extended 버전)를 설치했습니다.

brew install hugo

설치 완료 후 바이너리 실행 및 버전을 확인했습니다.

hugo version

insights 주요 학습

  • 프로젝트 빌드 파이프라인에서 사용하는 CLI 도구의 최소 버전 및 런타임 의존성을 README 및 실행 스크립트에 명시해야 환경 세팅 병목을 방지할 수 있습니다.