HTGB
How To

“Make: 명령어를 찾을 수 없습니다” 오류를 효율적으로 해결하는 방법

February 12, 2026 1 분 읽기 Updated: February 12, 2026

“make 명령어를 찾을 수 없습니다”라는 오류는 꽤 짜증나는 일이죠.특히 뭔가를 실행하면 바로 완료되는 데 익숙한 사람들에게는 더욱 그렇습니다.보통 이 오류는 make가 설치되어 있지 않거나, PATH 환경 변수에 추가되어 있지 않기 때문에 발생합니다. Linux, Mac, Windows 등 모든 플랫폼에서 발생하지만, 플랫폼마다 약간의 차이가 있을 수 있습니다.기본적으로 터미널에서 빌드, 컴파일 또는 코드 수정 작업을 하다가 이 오류가 발생하면 시스템 설정을 점검해야 합니다.

이 문제를 해결하는 방법을 알면 매번 머리를 벽에 찧지 않고도 다시 작업에 집중할 수 있습니다.핵심은 make가 실제로 설치되어 있고 올바른 위치에서 호출되는지 확인하는 것입니다.때로는 PATH 문제일 수도 있고, 때로는 전체 설치가 필요할 수도 있습니다.다음은 사용자의 환경에 따라 시도해 볼 수 있는 방법입니다.

make 명령어를 찾을 수 없다는 오류를 해결하는 방법

리눅스에서

리눅스 사용자라면 make 명령어가 아예 없는 경우가 있을 수 있습니다.보통 make는 설치되어 있지만 PATH 환경 변수에 추가되어 있지 않거나, 아예 설치한 적이 없는 경우가 많습니다.먼저 패키지 목록을 업데이트해 보세요.특히 데비안이나 우분투에서는 저장소가 최신 상태가 아닌 경우가 종종 있습니다.다음 명령어를 사용하면 패키지 목록을 업데이트할 수 있습니다.

  • sudo apt-get update

Arch Linux에서는 다음을 사용하세요.

  • sudo pacman -Syu

업데이트가 완료되면 다음 명령으로 make를 설치할 수 있습니다.

  • 데비안/우분투: sudo apt-get install -y make
  • 페도라/센트로스: sudo yum install make
  • 아치: sudo pacman -S make

그래도 문제가 해결되지 않으면 make를 포함한 더 큰 규모의 빌드 도구 세트가 필요할 수 있습니다.데비안/우분투에서 build-essential을 설치하는 것이 일반적인 해결책입니다.

  • sudo apt install -y build-essential

설치 후 make가 /usr/bin 또는 /usr/local/bin 디렉터리 어딘가에 있는지 확인하십시오.이 디렉터리들은 PATH에 포함되어 있어야 하지만, 그렇지 않은 경우 다음과 같이 수동으로 추가할 수 있습니다.

export PATH=$PATH:/usr/bin

또는 make가 있는 디렉토리를 확인하세요.대부분의 배포판에서는 make가 해당 위치에 있기 때문에 보통 이렇게 하면 문제가 해결됩니다.하지만 일부 시스템, 특히 최소 설치 시스템에서는 다시 한번 확인해야 할 수도 있습니다.

Windows에서

Windows는 완전히 다른 세상입니다. Make는 기본적으로 설치되어 있지 않으므로 설치해야 합니다.가장 쉬운 방법은 Chocolatey를 사용하는 것입니다.

  1. Enter 키 를 누르고 Win + R, 입력 powershell하고, Enter 키를 누르세요.
  2. 다음 명령어를 붙여넣어 Chocolatey(윈도우용 패키지 관리자)를 설치하세요.
  3. Set-ExecutionPolicy Bypass -Scope Process -Force; [System. Net. ServicePointManager]::SecurityProtocol = [System. Net. ServicePointManager]::SecurityProtocol -bor 3072; iex ((New-Object System. Net. WebClient).DownloadString('https://community.chocolatey.org/install.ps1'))
  4. 설치가 완료되면 PowerShell 또는 CMD를 다시 시작하고 다음을 입력하십시오 choco install make.

이렇게 하면 make가 시스템에 추가될 것입니다.그래도 작동하지 않으면 환경 변수를 확인하세요.시스템 속성 > 환경 변수 로 이동하여 make가 있는 디렉터리가 PATH에 포함되어 있는지 확인하십시오. MinGW 또는 유사한 환경을 사용하는 경우 경로가 `/.make/make.php`와 같은 형식일 수 있습니다 C:\MinGW\bin.해당 경로가 있는지 확인하거나, `make`를 전체 경로로 직접 실행해 보세요.예를 들어 `make.make/make.php`와 같이 경로를 지정할 수도 있습니다.C:\MinGW\bin\make.exe(혹은 `make.make/make.php`처럼 이름이 다를 수도 있습니다 mingw32-make.exe.)

맥에서

맥 사용자라면 Xcode나 Homebrew가 있으면 좀 더 쉽습니다.우선 Xcode 명령줄 도구가 필요합니다 (물론 macOS는 모든 것을 조금 더 어렵게 만들어야 하죠).

Xcode는 App Store에서 설치하거나, ​​용량을 줄이려면 다음 명령어를 실행하세요.

xcode-select --install

그러면 make를 포함한 도구를 다운로드하라는 팝업 창이 나타납니다. Homebrew(패키지 관리에 아주 유용합니다)를 선호하는 경우, 먼저 [웹사이트](https://brew.sh/)에서 Homebrew를 설치한 다음 다음 명령어를 실행하세요.

brew install make

설치가 완료되면 다음 명령어를 입력하여 make 명령어가 실행 가능한지 확인하십시오.

which make

찾을 수 없다면 경로 문제일 가능성이 높습니다.이전 Xcode 버전에서는 다음을 추가하세요.

export PATH=$PATH:/Developer/usr/bin

Xcode 최신 버전의 경우 경로는 다음과 같을 수 있습니다.

export PATH=$PATH:/Applications/Xcode.app/Contents/Developer/usr/bin

변경 사항을 적용한 후에는 터미널을 다시 시작하는 것을 잊지 마세요.

환경을 재구축하거나 다시 시작하세요

가끔 make를 설치했는데도 터미널이나 IDE에서 인식하지 못하는 경우가 있습니다.터미널을 닫았다가 다시 열거나, `make` 또는 `make-profile` 명령어를 사용하여 프로필을 다시 불러오세요 source ~/.bashrc.source ~/.zshrcWindows에서는 명령 프롬프트나 PowerShell을 다시 시작해 보세요.약간 번거롭긴 하지만 해볼 만한 가치가 있습니다.

그래도 안 되면 어쩌죠? 특단의 조치를 취해야죠.

다른 모든 방법이 실패하면 PATH 환경 변수와 make 설치 위치를 다시 확인하세요.which make(Linux, Mac) 또는 where make(Windows)와 같은 명령어를 사용하여 make가 시스템에 인식되는지 확인할 수 있습니다.필요한 경우 해당 디렉터리를 PATH 환경 변수에 수동으로 추가하세요.환경 변수에 오타가 있거나 세미콜론이 누락된 것과 같은 사소한 문제가 원인일 수도 있습니다.

코드 공간 재구축

혹시 GitHub Codespaces에서 컴파일을 시도했는데 make 명령어를 찾을 수 없다는 오류가 발생하는 드문 경우라면, GitHub Codespaces 페이지 에서 해당 코드스페이스를 삭제하고 다시 생성해 보세요.캐시나 초기 설정에 문제가 생기는 경우가 있는데, 새로 시작하면 도움이 될 수 있습니다.번거롭긴 하지만 시도해 볼 가치가 있습니다.

요점은 이렇습니다.”make 명령어를 찾을 수 없음” 오류를 해결하는 건 꽤 까다로울 수 있지만, 대개 설치와 PATH 환경 변수 설정 문제입니다.약간의 인내심이 필요하지만, 해결에 큰 어려움은 없습니다.행운을 빌며, 이 정보가 여러분이 시간 낭비하는 것을 막아주길 바랍니다.

요약

  • make가 설치되어 있는지 확인하십시오.설치되어 있지 않으면 패키지 관리자를 통해 설치하십시오.
  • make의 바이너리 파일이 시스템 PATH에 포함되어 있는지 확인하십시오.
  • Windows에서는 Chocolatey를 사용하거나 경로를 수동으로 추가하세요.
  • Mac에서는 Xcode CLI 도구를 설치하거나 Homebrew를 사용하세요.
  • 변경 사항을 적용한 후에는 터미널이나 IDE를 다시 시작하십시오.
  • 다른 모든 방법이 실패하면 PATH를 다시 ​​한번 확인하십시오 which make.where make
  • GitHub를 사용 중이라면 코드스페이스를 다시 빌드해 보세요.

마무리

이 정보가 누군가의 설정 과정에서 겪는 어려움을 조금이라도 덜어주길 바랍니다.보통은 누락된 파일이 있거나 경로 설정에 문제가 있는 경우가 많고, 이를 해결하면 다시 작업을 진행할 수 있습니다.해결 방법이 항상 간단하지는 않겠지만, 적어도 어디를 살펴봐야 할지는 알게 되었으니 다행입니다.행운을 빌며, 때로는 재부팅이나 재설치로 가장 이상한 문제도 해결될 수 있다는 점을 기억하세요.