한 시스템에서 다른 시스템으로 Python 모듈 복사하는 방법

Python 모듈을 다른 시스템으로 옮기는 올바른 방법

직접 작성한 Python 모듈을 다른 시스템에서 사용하고 싶다면, 해당 파일을 그대로 복사하여 Python이 설치된 다른 시스템에서 실행하면 됩니다. 하지만 이미 설치된 외부 모듈(패키지)을 옮기고 싶다면 단순 파일 복사는 권장되지 않습니다.

1단계: 두 시스템에 동일한 Python 버전 설치

가장 먼저 해야 할 일은 두 번째 시스템에 첫 번째 시스템과 동일한 버전의 Python을 설치하는 것입니다. 버전 차이가 있으면 모듈 호환성 문제가 발생할 수 있습니다.

2단계: 설치된 모듈 목록 추출하기

첫 번째 시스템에서 아래 명령어를 실행하면 현재 설치된 모든 모듈 목록이 installed_modules.txt 파일로 저장됩니다.

$ pip freeze > installed_modules.txt

3단계: 목록 파일을 새 시스템으로 복사 후 일괄 설치

생성된 텍스트 파일을 두 번째 시스템으로 옮긴 뒤, pip를 이용해 목록에 있는 모든 모듈을 한 번에 설치합니다.

$ pip install -r installed_modules.txt

이 명령 하나로 첫 번째 시스템에 설치되어 있던 모든 모듈이 자동으로 설치됩니다.

왜 단순 복사·붙여넣기는 안 될까?

모듈 폴더를 직접 복사해서 붙여넣는 방식은 간편해 보이지만, 운영체제(OS), CPU 아키텍처, Python 버전 등의 차이로 인해 오류가 발생하기 쉽습니다. 특히 C 확장 기반 패키지는 플랫폼별로 컴파일된 바이너리가 달라지므로 호환되지 않을 수 있습니다.

따라서 pip freeze와 pip install -r 조합을 사용하는 것이 가장 안전하고 확실한 방법입니다. 참고로 프로젝트별 환경을 관리한다면 virtualenv나 venv 같은 가상 환경 도구와 함께 사용하면 더욱 체계적으로 의존성을 관리할 수 있습니다.