Search
Duplicate

4. 스트림릿 실행오류(with 시스템환경변수)

목차(클릭하세요)
오류수정은 시스템 환경변수를 정확히 수정하기

1. 가상환경에서 발생하는 오류들

1-1. 문제 상황 설명

[예시]현재 아나콘다에는 2개의 가상환경이 셋팅되어 있고, 1개의 가상환경명은 stream으로 셋팅되어 있음
stream가상환경에는 streamlit 라이브러리가 잘 설치되어 있음
바탕화면의 2개의 폴더(각각 A,B)에는 스트림릿을 활용한 동일한 소스코드가 동일하게 들어있음
A폴더를 vsc코드로 열고, ‘streamlit run 파일명.py’를 실행할 경우 잘 실행됨
하지만 B폴더를 vsc코드로 열고, ‘streamlit run 파일명.py’를 실행할 경우, 스트림릿을 실행할 수 없다는 오류만 발생

1-2. 전제조건

가상환경이 잘 셋팅되어 있고, vsc코드를 열었을때, streamlit이 설치된 가상환경 파이썬 인터프리터를 동일하게 선택한 것임
해당 터미널에서 가상환경명칭이 괄호앞에 있을 경우는 가상환경이 잘 활성화 되어있다는 상태임

1-3. 왜 실패했는가?

현재 상황 요약

폴더
설명
실행 여부
stream 폴더
conda 가상환경과 논리적으로 연결된 상태
실행됨
sj 폴더
단순히 파이썬 파일만 존재하며, 가상환경과 연결 안됨
실행 안됨
즉, 현재 (stream)은 Anaconda 기반의 가상환경이며, 이 가상환경은 stream 폴더에만 논리적으로 연결되어 사용 중임.

2. 해결방안

2-1. 시스템 환경변수 설정 방법 (Windows 기준)

순서

1.
Win + S → "환경 변수" 검색 → "시스템 환경 변수 편집" 클릭
2.
하단 [환경 변수(N)...] 버튼 클릭
3.
사용자 변수 or 시스템 변수에서 Path 항목 선택 후 [편집]
4.
새로 만들기 클릭 → 아래 경로 추가:
C:\Users\user\.conda\envs\stream\Scripts\
Bash
복사
5.
확인 → 확인 → 확인 해서 저장
6.
명령 프롬프트(cmd)를 완전히 껐다가 새로 켜기

2-2. 무엇이 달라지는 것인가?

스트림릿이 설정된 환경변수를 추가하니, 모든 폴더에서 접근이 가능해진 것임

핵심

항목
설명
목적
특정 폴더(예: C:\Users\user\.conda\envs\stream\Scripts) 안에 있는 streamlit.exe를 전역 명령어로 실행 가능하게 설정
효과
가상환경이 활성화되지 않은 다른 디렉토리(예: sj 폴더)에서도 streamlit 명령어를 인식
변경 대상
사용자 환경변수(Path) 혹은 시스템 환경변수(Path)
필수 조치
환경변수 변경 후에는 반드시 CMD를 재시작해야 적용됨

3. 실행결과

3-1. 각각의 폴더에서 스트림릿 실행해보기

3-2.결론

범인은 시스템 변수