Python pip install 'SyntaxError: invalid syntax' 오류 해결 방법

pip 패키지 설치 도구는 반드시 명령줄(커맨드 라인)에서 실행해야 합니다. 파이썬 인터프리터나 파이썬 프로그램 내부에서 패키지를 설치하려고 하면 SyntaxError: invalid syntax 오류가 발생합니다.

이 가이드에서는 pip install 잘못된 구문 오류의 원인과 의미를 살펴보고, 실제 예제를 통해 이 오류를 수정하는 방법을 단계별로 알아보겠습니다.

pip install invalid syntax 오류란?

파이썬 pip는 패키지 설치 도구입니다. pip를 사용하면 Python Package Index(PyPI)에서 수천 개의 라이브러리를 검색하고 다운로드하여 코드에 활용할 수 있습니다.

pip는 독립적인 명령줄 인터페이스로 동작하며, 파이썬 설치와는 별개의 도구입니다. 그 이유는 pip가 코드를 실행하는 도구가 아니라 패키지를 설치하는 전용 프로그램이기 때문입니다.

만약 두 도구가 하나로 묶여 있다면, 파이썬 프로그램을 실행하는 구문과 모듈을 설치하는 구문이 서로 비슷해져 개발자에게 혼란을 줄 것입니다.

이러한 방식은 다른 프로그래밍 환경에서도 마찬가지입니다. Node.js는 npm으로 패키지를 설치하고, 프로그램을 실행할 때는 별도의 node 명령어를 사용합니다.

오류 발생 예제

개발 환경에 Beautiful Soup 4(bs4) 라이브러리를 설치해 보겠습니다. 이 라이브러리는 웹 페이지를 스크래핑하고 특정 데이터를 추출할 때 널리 사용됩니다.

먼저 터미널에서 python3 명령어로 파이썬 3 셸을 실행합니다:

python3

그러면 대화형 셸이 열리고, 여기서 파이썬 코드를 작성할 수 있습니다:

Python 3.8.5 (v3.8.5:580fbb018f, Jul 20 2020, 12:11:27)
[Clang 6.0 (clang-600.0.57)] on darwin
Type "help", "copyright", "credits" or "license" for more information.
>>>

다음으로 bs4 라이브러리를 임포트해 보겠습니다. 외부 라이브러리는 프로그램이나 셸에서 참조하기 전에 반드시 먼저 임포트해야 합니다:

>>> from bs4 import BeautifulSoup
Traceback (most recent call last):
  File "<stdin>", line 1, in <module>
ModuleNotFoundError: No module named 'bs4'

패키지를 임포트하려고 하면 ModuleNotFoundError가 발생합니다. 파이썬이 필요한 패키지 모듈을 찾지 못했다는 의미이며, 프로그램 작성을 계속 진행할 수 없습니다. bs4 라이브러리를 설치해서 이 문제를 해결해 보겠습니다:

>>> pip install bs4

하지만 이번에는 또 다른 오류가 나타납니다:

File "<stdin>", line 1
    pip3 install bs4
     ^
SyntaxError: invalid syntax

파이썬 셸 안에서는 pip3 명령어로 bs4를 설치할 수 없습니다. pip3는 파이썬 3 패키지를 위한 설치 도구입니다.

해결 방법

앞선 시도가 실패한 이유는 파이썬 인터프리터 내부에서 bs4 패키지를 설치하려고 했기 때문입니다. python3 명령어로 파이썬 3를 연 상태에서 pip3 install 명령어를 실행했습니다.

파이썬에서 pip install 잘못된 구문 오류가 발생하는 근본적인 이유는, pip가 파이썬의 키워드나 문법 요소가 아니기 때문입니다. pip는 명령줄 셸에서 실행해야 하는 독립적인 도구입니다.

이 오류를 해결하려면 먼저 파이썬 셸을 종료해야 합니다:

>>> exit()

exit() 명령어는 열려 있는 파이썬 인터프리터를 닫습니다. 그다음 명령 프롬프트(터미널)에서 bs4를 설치합니다:

pip3 install bs4

이 명령어를 실행하면 시스템에 bs4 라이브러리가 설치됩니다. 설치가 완료되면 새로운 파이썬 셸을 엽니다:

python3

새로 연 셸에서는 bs4 라이브러리에 접근할 수 있습니다. 직접 임포트해서 확인해 보겠습니다:

>>> from bs4 import BeautifulSoup
>>>

오류 없이 임포트가 완료되었습니다. 이제 프로그램에서 bs4를 자유롭게 사용할 수 있습니다.

마무리

pip install invalid syntax 오류는 파이썬 인터프리터 내부에서 패키지를 설치하려고 할 때 발생합니다. 이 오류를 해결하려면 exit()로 인터프리터를 종료한 후, 명령줄 셸에서 pip install 명령어를 실행하면 됩니다.

참고로 최신 파이썬 환경에서는 python -m pip install 패키지명 형태로 실행하는 방법도 권장됩니다. 이 방식은 현재 활성화된 파이썬 환경에 정확히 패키지를 설치할 수 있어, 가상환경(virtualenv, venv 등)을 사용할 때 특히 유용합니다.

이제 여러분도 전문 개발자처럼 이 오류를 손쉽게 해결할 수 있습니다!