LightNode 로고

Linux에서 “apt command not found” 오류 해결 방법

LightNode
작성자 LightNode · · 업데이트 2026-07-06

빠른 해결: "apt command not found" (2026)

"apt command not found" 오류는 셸이 apt 실행 파일을 찾지 못한다는 뜻입니다. 거의 모든 경우 네 가지 원인 중 하나입니다. 다음 해결책을 순서대로 시도하세요:

  1. Debian/Ubuntu 시스템인지 확인하세요. apt는 Debian 기반 배포판(Ubuntu 24.04, Ubuntu 22.04, Debian 12, Linux Mint, Pop!_OS)에서만 존재합니다. Fedora, CentOS, RHEL, Rocky, AlmaLinux(dnf 사용), Arch(pacman 사용), openSUSE(zypper 사용)에는 존재하지 않습니다. 배포판을 확인하세요:

    cat /etc/os-release

  2. apt를 전체 경로로 실행하세요. apt가 설치되어 있지만 셸이 찾지 못한다면 직접 호출하세요:

    /usr/bin/apt update

    이것이 작동한다면 문제는 apt 자체가 아니라 PATH입니다.

  3. PATH를 수정하세요. 깨졌거나 덮어써진 PATH(또는 PATH에 시스템 디렉터리가 없는 사용자로 로그인한 경우) 때문에 apt가 가려집니다. 표준 디렉터리를 복원하세요:

    export PATH=/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin:$PATH

    그런 다음 which apt로 확인하세요(/usr/bin/apt가 출력되어야 합니다). 이 줄을 ~/.bashrc에 추가하면 영구적으로 적용됩니다.

  4. apt를 재설치하거나 복구하세요. Debian/Ubuntu 시스템에서 apt가 실제로 누락된 경우(드물며, 보통 업그레이드가 손상된 후 발생) 패키지 도구를 복구하세요:

    sudo dpkg --configure -a
sudo apt-get update
sudo apt-get install --reinstall apt

    apt-get도 없다면 거의 확실히 Debian 기반 시스템이 아닙니다 — 원인 #1을 참고하세요.

한 줄 진단: which apt || echo "not in PATH"를 실행하세요. 경로가 출력되면 해결책 #3(PATH)을 사용하세요. "not in PATH"가 출력되면 해결책 #1(잘못된 배포판) 또는 #4(재설치)를 사용하세요. 이 가이드의 나머지 부분(Ubuntu 24.04 LTS 및 22.04 LTS 대상 2026년 7월 업데이트)에서는 각 원인을 자세히 설명합니다.

소개

APT(Advanced Package Tool)는 Ubuntu, Linux Mint, Debian 등 Debian 기반 Linux 배포판에서 사용되는 강력한 패키지 관리 시스템입니다. 이 도구는 소프트웨어 패키지의 설치, 업데이트 및 제거 과정을 간소화합니다. 그러나 사용자가 이 필수 도구를 사용하려 할 때 가끔씩 “apt command not found”라는 답답한 오류를 마주할 수 있습니다.

이 오류는 일반적으로 다음과 같은 상황에서 발생합니다:

  1. Linux 초보자: Linux 시스템에 익숙하지 않고 패키지 관리에 대해 잘 모르는 사용자가 Debian 기반이 아닌 배포판을 사용할 때 발생할 수 있습니다.

  2. 시스템 설정 오류: 시스템 업데이트나 시스템 파일의 잘못된 수정으로 인해 이 오류가 발생할 수 있습니다.

  3. 불완전한 설치: 드물게, 시스템 설치가 불완전하거나 손상되어 apt와 같은 필수 명령어가 누락될 수 있습니다.

  4. 잘못된 배포판: CentOS나 Fedora처럼 apt를 사용하지 않는 Linux 배포판에서 apt를 사용하려 할 때 발생합니다.

  5. PATH 문제: 시스템의 PATH 변수에 apt가 위치한 디렉터리가 포함되어 있지 않아 이 오류가 발생할 수 있습니다.

“apt command not found” 오류를 이해하고 해결하는 것은 Linux 시스템을 효과적으로 유지 관리하는 데 매우 중요합니다. 다음 섹션에서는 이 오류의 원인을 자세히 살펴보고 단계별 해결 방법을 제공하여 시스템 패키지 관리를 원활하게 할 수 있도록 도와드리겠습니다.

오류 이해하기

“apt command not found” 오류가 발생했을 때, 이 메시지가 의미하는 바와 원인을 이해하는 것이 중요합니다. 이를 통해 문제에 보다 효과적으로 접근할 수 있습니다.

“apt command not found”는 무슨 뜻인가요?

“apt command not found” 오류 메시지는 시스템의 셸(명령줄 인터페이스)이 시스템 PATH에 나열된 디렉터리 중 어디에서도 apt 명령어를 찾을 수 없다는 뜻입니다. 즉, 터미널에 apt를 입력했을 때 시스템이 이 명령어의 실행 파일 위치를 알지 못한다는 의미입니다.

이 오류는 Linux 시스템에서 흔히 발생하는 “command not found” 오류의 한 종류입니다. 반드시 apt가 설치되어 있지 않다는 뜻은 아니며, 단지 시스템이 어디서 찾아야 할지 모르는 경우일 수 있습니다.

이 오류의 가능한 원인

“apt command not found” 오류를 일으킬 수 있는 여러 가지 원인이 있습니다:

  1. APT가 설치되어 있지 않음: Debian 기반 시스템에서는 드문 경우지만, 설치가 불완전하거나 손상된 경우 발생할 수 있습니다.

  2. 비-Debian 기반 배포판 사용: Fedora, CentOS, Arch Linux 등 apt를 패키지 관리자로 사용하지 않는 배포판에서 apt를 사용하려 할 때 발생합니다.

  3. 잘못된 PATH 변수: 시스템 PATH 변수에 apt가 위치한 디렉터리가 포함되어 있지 않을 수 있습니다. PATH가 잘못 수정된 경우가 이에 해당합니다.

  4. 심볼릭 링크 문제: apt 명령어에 대한 심볼릭 링크가 깨졌거나 누락된 경우가 있습니다.

  5. 시스템 파일 손상: 업데이트나 업그레이드 도중 중단되어 시스템 파일이 손상된 경우 드물게 발생할 수 있습니다.

  6. 오타 또는 대소문자 구분: Linux 명령어는 대소문자를 구분한다는 점을 기억하세요. ‘apt’ 대신 ‘APT’를 입력하면 “command not found” 오류가 발생합니다.

오류 해결 방법

“apt command not found” 오류의 의미와 원인을 이해했으니, 이제 이 문제를 해결할 수 있는 다양한 방법을 살펴보겠습니다.

1. apt가 설치되어 있는지 확인하기

먼저 시스템에 apt가 실제로 설치되어 있는지 확인해야 합니다.

  • 터미널을 열고 apt 실행 파일 위치를 확인해 보세요: 
    which apt
  • apt가 설치되어 있다면 이 명령어는 보통 /usr/bin/apt와 같은 경로를 반환합니다.
  • 출력이 없다면 apt가 설치되어 있지 않을 수 있습니다.

Debian 기반 시스템(예: Ubuntu 24.04/22.04 또는 Debian 12/13)에서 apt를 설치하거나 복구하려면:

sudo dpkg --configure -a
sudo apt-get update
sudo apt-get install --reinstall apt

dpkg --configure -a 단계는 중단된 패키지 작업을 마무리합니다(업그레이드 실패 후 apt가 깨지는 흔한 원인입니다). 참고: 만약 apt-get도 찾을 수 없다면 시스템이 거의 확실히 Debian 기반이 아니거나 더 심각한 문제가 있는 것이므로, cat /etc/os-release로 배포판을 확인하세요.

2. PATH 환경 변수 업데이트하기

apt가 설치되어 있지만 찾을 수 없다면 PATH 변수에 apt 위치가 포함되어 있지 않을 수 있습니다.

  • 현재 PATH를 확인하세요: 
    echo $PATH
  • 출력에 /usr/bin이 없다면 다음 명령어로 추가하세요: 
    export PATH=$PATH:/usr/bin
  • 이 변경을 영구적으로 적용하려면 위 명령어를 ~/.bashrc 또는 ~/.bash_profile 파일에 추가하세요.

3. apt의 전체 경로 사용하기

빠른 해결책으로 apt의 전체 경로를 사용해 볼 수 있습니다:

/usr/bin/apt update

이 방법으로 apt가 존재하고 실행 가능한지 확인할 수 있습니다.

4. apt 호환 배포판으로 전환하기

Debian 기반 시스템이 아니라면, apt가 필수라면 Debian 기반 배포판으로 전환하는 것을 고려해 보세요. 대표적인 apt 호환 배포판(2026년 기준 현재 버전)은 다음과 같습니다:

  • Ubuntu (24.04 LTS "Noble Numbat"와 22.04 LTS "Jammy Jellyfish"가 현재 지원되는 LTS 릴리스입니다)
  • Debian (13 "Trixie" 및 12 "Bookworm")
  • Linux Mint (22.x, Ubuntu 24.04 기반)
  • Pop!_OS

배포판 전환은 큰 변화이므로 신중히 결정해야 합니다.

5. 대체 패키지 관리자 사용하기

비-Debian 기반 시스템이라면 해당 배포판의 기본 패키지 관리자를 사용하는 법을 익히는 것이 좋습니다:

  • Fedora/CentOS/RHEL: dnf 또는 yum
  • Arch Linux: pacman
  • openSUSE: zypper

예시 (Fedora에서):

sudo dnf update

예방 팁

앞으로 “apt command not found” 오류를 피하기 위해 다음과 같은 모범 사례를 고려하세요:

  1. 공식 저장소 사용: 소프트웨어 설치 시 배포판의 공식 저장소를 우선 사용하세요. 시스템 일관성을 유지하고 패키지 충돌 위험을 줄일 수 있습니다.

  2. 정기적인 시스템 업데이트: 정기적으로 업데이트 및 업그레이드 명령어를 실행해 시스템 도구(apt 포함)를 최신 상태로 유지하세요.

  3. 시스템 수정 주의: 특히 패키지 관리나 PATH 변수 관련 시스템 파일을 불필요하게 변경하지 마세요.

  4. 올바른 패키지 관리자 사용: 배포판에 맞는 패키지 관리자를 사용하세요. 확실하지 않으면 배포판 문서를 참고하세요.

  5. 중요 데이터 백업: 시스템 데이터를 정기적으로 백업하세요. 심각한 패키지 관리 문제로 시스템 재설치가 필요할 때 큰 도움이 됩니다.

  6. 기본 문제 해결법 익히기: 설치된 패키지 확인, 환경 변수 관리, 오류 메시지 해석 등 기본적인 Linux 문제 해결법을 익히면 시간을 절약할 수 있습니다.

Fix apt not found

자주 묻는 질문 (FAQ)

Q: 모든 Linux 배포판에서 apt를 사용할 수 있나요?

A: 아니요, apt는 주로 Ubuntu, Debian, Linux Mint 같은 Debian 기반 배포판에서 사용됩니다. 다른 배포판은 각기 다른 패키지 관리자를 사용합니다(예: Fedora는 dnf, Arch Linux는 pacman).

Q: apt와 apt-get의 차이점은 무엇인가요?

A: apt는 apt-get과 apt-cache의 자주 쓰이는 명령어를 더 사용자 친화적이고 일관된 구조로 제공하는 최신 인터페이스입니다.

Q: 내가 사용하는 apt 버전을 어떻게 확인하나요?

A: 터미널에서 apt --version 명령어를 실행하면 apt 버전을 확인할 수 있습니다.

Q: 시스템에서 apt를 제거해도 안전한가요?

A: Debian 기반 시스템에서 apt는 필수 도구이므로 제거하는 것은 권장하지 않습니다. 제거 시 시스템 불안정이 발생할 수 있습니다.

Q: 공식 저장소 외부에서 소프트웨어를 설치할 때도 apt를 사용할 수 있나요?

A: apt는 주로 공식 저장소와 함께 사용되지만, PPA와 같은 서드파티 저장소를 추가해 공식 저장소에 없는 소프트웨어를 설치할 수도 있습니다. 다만 비공식 소스 사용 시 주의가 필요합니다.

Q: apt 업데이트나 설치 중 오류가 발생하면 어떻게 해야 하나요?

A: 먼저 sudo apt update를 실행해 패키지 목록을 갱신하세요. 오류가 계속되면 인터넷 연결, 디스크 공간, 오류 메시지를 확인해 문제 원인을 찾아보세요.

Q: apt update는 얼마나 자주 실행해야 하나요?

A: 새 패키지 설치나 시스템 업그레이드 전에 sudo apt update를 실행하는 것이 좋습니다. 일부 사용자는 매일 또는 매주 실행하기도 합니다.

Q: apt로 설치한 패키지를 되돌릴 수 있나요?

A: 네, sudo apt remove 패키지명으로 패키지를 제거할 수 있습니다. 설정 파일까지 완전히 제거하려면 sudo apt purge 패키지명을 사용하세요.

Q: upgrade와 dist-upgrade의 차이는 무엇인가요?

A: apt upgrade는 현재 설치된 모든 패키지의 업그레이드를 설치하지만, 패키지를 제거하거나 새로 설치하지는 않습니다. apt dist-upgrade는 의존성 문제 해결을 위해 새 패키지를 설치하거나 기존 패키지를 제거할 수도 있습니다.

Q: apt로 패키지를 다운그레이드할 수 있나요?

A: apt에는 직접적인 다운그레이드 명령어가 없지만, sudo apt install 패키지명=버전번호로 특정 버전을 설치할 수 있습니다. 다만 패키지 다운그레이드는 의존성 문제를 일으킬 수 있으므로, 필요한 경우가 아니면 일반적으로 권장하지 않습니다.

목록으로 돌아가기