uv 관리 Python 3.14 어떻게 사용하나요? 2026 Mac 초보자 원격 튜토리얼

화면에 Python은 열리지만 라이브러리 설치 때마다 오류가 나고, 어떤 Python을 실행하는지도 헷갈립니다.

이번 주에는 제출용 폴더와 분리한 새 연습 프로젝트에서 uv 관리 Python 3.14를 먼저 시험해 보세요. 새 프로젝트는 uv로 관리해도 되지만, 이미 제출을 앞둔 수업 환경은 바로 바꾸지 말고 같은 코드가 재현되는지 확인한 뒤 결정하는 것이 가장 안전합니다.

이 글은 처음 Python을 배우며 버전과 의존성 문제를 줄이고 싶은 학생을 위한 안내입니다. 학교 컴퓨터에서 설치 권한이 없거나, 여러 Python이 섞여 명령어가 엉뚱한 환경을 가리키는 경우에도 적합합니다. macOS를 직접 쓰는 경우와 원격 Mac을 사용하는 경우를 나누어 설명합니다.

첫 과제에서 uv를 선택할지 판단하는 기준

몇 줄의 Python 코드만 실행한다면 기존에 설치된 Python으로도 충분합니다. 반대로 여러 외부 라이브러리를 설치하거나, 며칠 뒤 같은 프로젝트를 다시 열어야 한다면 uv가 유리합니다. uv는 Python 버전 선택, 가상 환경, 프로젝트 의존성과 잠금 파일을 한 흐름으로 다루는 도구입니다. 모든 수업에 반드시 필요한 도구는 아닙니다.

여기서 가상 환경은 다른 과제와 섞이지 않는 독립 작업 책상입니다. 의존성은 그 책상에서 필요한 공구 목록이고, 잠금 파일은 나중에 같은 공구 조합을 다시 준비하기 위한 작업 기록입니다. 이 구분을 이해하면 pip 오류를 무작정 반복하는 대신 프로젝트별 환경을 점검할 수 있습니다.

uv 관리 Python 3.14를 Mac 새 프로젝트에 적용하는 순서

Python 3.14의 공식 배포 정보는 Python 3.14 공식 발표 페이지에서 확인할 수 있습니다. uv의 설치 방식은 운영 체제와 셸에 따라 달라지므로 uv 공식 설치 안내에 있는 명령을 그대로 사용하세요. 출처가 불분명한 설치 스크립트는 실행하지 않는 것이 좋습니다.

첫 단계: 제출 폴더와 분리한 연습 폴더 만들기

터미널에서 먼저 연습용 폴더로 이동합니다.

mkdir python-uv-practice
cd python-uv-practice

mkdir은 폴더를 만들고 cd는 현재 작업 위치를 바꿉니다. 이후 명령이 어느 폴더에서 실행되는지 확인하는 습관이 중요합니다. 현재 위치는 다음 명령으로 확인할 수 있습니다.

pwd

그 다음 uv 공식 프로젝트 안내에 따라 새 프로젝트를 초기화합니다.

uv init

화면에 프로젝트 파일이 만들어졌다면 성공입니다. 아직 시스템 Python을 삭제하거나 전역 설정을 수정하지 않았다는 점도 확인하세요.

두 번째 단계: Python 3.14를 프로젝트에 연결하기

uv의 Python 버전 관리 문서는 프로젝트에 사용할 Python 버전을 선택하는 방법을 설명합니다. 다음처럼 Python 3.14 환경을 만들 수 있습니다.

uv python install 3.14
uv venv --python 3.14

명령이 끝난 뒤에도 python이 항상 원하는 실행 파일을 가리킨다고 가정하면 안 됩니다. 프로젝트 환경을 통해 실행해야 합니다.

uv run python --version

출력에 Python 3.14가 표시되면 현재 프로젝트가 해당 버전을 사용하고 있는 것입니다. 실제 출력은 운영 체제와 설치 상태에 따라 달라질 수 있으므로, 화면에 나온 버전을 직접 확인해야 합니다.

주의: sudo로 전역 설치하거나 macOS에 기본으로 들어 있는 Python을 삭제하지 마세요. 학습 중인 다른 도구와 수업 프로젝트까지 함께 고장 날 수 있습니다.

세 번째 단계: 첫 파일과 의존성 확인하기

간단한 파일을 만듭니다.

from pathlib import Path

Path("result.txt").write_text("Python 3.14 practice", encoding="utf-8")
print("파일을 저장했습니다.")

파일 이름을 main.py로 저장한 뒤 실행합니다.

uv run python main.py

result.txt가 같은 프로젝트 폴더에 생기면 파일 쓰기까지 확인한 것입니다. 외부 패키지를 추가할 때는 다음처럼 프로젝트 명령을 사용합니다.

uv add requests
uv run python main.py

프로젝트의 의존성 관리와 잠금 파일 동작은 uv 프로젝트 구조 안내에서 확인할 수 있습니다. pyproject.toml은 프로젝트 설정과 필요한 패키지 목록을 담고, 잠금 파일은 재설치 때 참고할 구체적인 의존성 상태를 기록합니다.

uv run은 프로젝트 환경을 사용해 명령을 실행하므로, 별도의 전역 설치 상태에 덜 의존합니다. 그래도 선생님이 정한 실행 방식이 있다면 그 방식과 결과를 먼저 비교해야 합니다.

학교 컴퓨터에서는 설치보다 허용 범위를 먼저 확인합니다

학교 컴퓨터에 관리자 권한이 없다고 해서 장치 관리 설정을 우회하면 안 됩니다. 먼저 사용자 폴더에 도구를 둘 수 있는지, 터미널을 사용할 수 있는지, 브라우저 기반 실습이 허용되는지 담당자에게 확인하세요. 학교 계정이나 다른 학생의 파일이 남는 공용 장치라면 개인 토큰과 비밀번호를 저장하지 않는 것도 중요합니다.

다음 세 갈래로 판단하면 됩니다.

• 브라우저만 허용된다면 온라인 편집 환경에서 문법과 짧은 코드를 연습합니다. 다만 로컬 파일 구조와 uv 설치 과정까지는 확인하기 어렵습니다.
• Python이 이미 설치되어 있다면 버전과 실행 권한을 확인한 뒤, 수업에서 요구하는 방식으로 작은 코드를 실행합니다. 새로운 패키지 설치가 차단될 수 있습니다.
• 터미널 사용과 사용자 폴더 설치가 허용되지 않는다면, 허가된 원격 Mac에서 프로젝트를 만들 수 있습니다. 이 경우 파일은 학교 컴퓨터가 아니라 원격 환경이나 승인된 저장 위치에 보관합니다.

학교 컴퓨터에서 curl, 실행 파일 설치, 셸 설정 변경이 막혀 있다면 오류를 고치려고 보안 정책을 끄지 마세요. 과제 제출용 코드는 개인 저장 장치나 승인된 저장소에 남기고, 공용 브라우저에는 계정 자동 로그인을 사용하지 않는 편이 안전합니다.

원격 Mac에서는 연결 기기와 개발 환경을 분리합니다

원격 Mac으로 Python을 배우는 경우 uv와 Python, 프로젝트 폴더, 가상 환경은 원격 Mac에 설치합니다. 현재 사용하는 윈도우 컴퓨터나 학교 컴퓨터는 화면을 보고 키보드를 입력하는 연결 장치일 뿐입니다. 이 구조를 먼저 이해하면 연결이 끊겼을 때 프로젝트가 사라졌다고 오해하지 않게 됩니다.

원격 환경이 적합한 경우는 다음과 같습니다.

• 학교 장치에서 설치 권한이 없지만 정해진 기간 동안 macOS가 필요한 경우
• 집과 학교에서 같은 프로젝트 폴더를 이어서 열어야 하는 경우
• 개인 Mac을 구매하기 전에 Python 개발 환경을 시험하려는 경우

반대로 인터넷 연결이 불안정하거나, 실습 파일을 반드시 학교 컴퓨터 내부에만 저장해야 한다면 원격 방식이 맞지 않을 수 있습니다. 시작 전에 원격 화면 연결 방식과 파일 저장 정책을 확인하세요. VPSMAC의 원격 Mac 사용 환경을 살펴볼 때도 연결 방식, 파일 보존, 사용 기간을 먼저 비교해야 합니다.

네 번째 단계: 다시 연결해도 이어지는지 확인하기

원격 Mac에서는 다음 순서로 연속성을 시험합니다.

1. 원격 Mac에 연결하고 작업 폴더를 만듭니다.
2. uv와 Python 3.14를 확인합니다.
3. main.py를 작성하고 uv run python main.py로 실행합니다.
4. result.txt가 저장되었는지 확인합니다.
5. 연결을 종료한 뒤 다시 접속해 같은 폴더에서 명령을 반복합니다.
6. 의존성 목록과 프로젝트 파일이 그대로 있는지 확인합니다.

다시 접속했을 때 작업 폴더가 보이지 않으면 uv 문제가 아니라 파일을 잘못된 위치에 저장했거나 원격 환경의 보존 조건을 이해하지 못한 것일 수 있습니다. 이 점검을 통과한 뒤에야 장기 수업에 사용할지 판단하세요.

기존 수업 프로젝트는 성공보다 재현성을 먼저 봅니다

이미 requirements.txt, 가상 환경 폴더, 고정 실행 명령을 받은 수업이라면 새 프로젝트로 바로 옮기지 않는 편이 좋습니다. 선생님이 채점하는 환경과 네가 만든 환경이 달라지면, 코드가 실행되더라도 제출 과정에서 문제가 생길 수 있습니다.

새 프로젝트는 uv로 시작하고, 기존 프로젝트는 원래 방식을 유지하는 이중 운영도 가능합니다. 이전이 필요하다면 프로젝트를 복사한 뒤 다음 내용을 기록하세요.

• 기존 Python 버전
• 설치된 외부 패키지와 버전
• 실행 명령
• 입력 파일과 출력 파일의 위치
• 선생님이 요구한 제출 파일

그 후 pip 프로젝트에서 uv 프로젝트로 옮기는 공식 안내를 참고해 하나씩 변경합니다. 한 번 실행되었다고 전체 호환성이 확인된 것은 아닙니다. 파일 읽기, 외부 패키지 호출, 새 터미널에서의 재실행까지 확인해야 합니다.

개인 연습은 새 uv 프로젝트를 권합니다. 소그룹 프로젝트는 팀원이 같은 Python 버전과 실행 명령에 동의한 경우에만 옮기는 편이 좋습니다. 선생님이 고정 환경을 제공했다면 그 환경을 유지하고, uv는 별도 연습 폴더에서 배우는 것이 안정적입니다.

첫 주에 독립 프로젝트를 최종 점검하는 방법

다음 점검은 단순히 화면에 문장이 출력되는지보다 실제 학습 환경에 가깝습니다.

• 외부 패키지 하나를 프로젝트에 추가합니다.
• Python 코드에서 result.txt를 만들고 다시 읽습니다.
• 터미널을 닫았다가 프로젝트 폴더로 돌아옵니다.
• uv run python --version으로 실행 버전을 확인합니다.
• uv run python main.py를 다시 실행합니다.
• 프로젝트 파일과 잠금 파일이 보존되었는지 살펴봅니다.

이 결과에 따라 결정하면 됩니다.

• 모든 단계가 재현되면 새 학습 프로젝트는 uv를 계속 사용합니다.
• 코드 실행은 되지만 수업 파일 규칙이 다르면 개인 연습은 uv로, 수업 과제는 기존 환경으로 나눕니다.
• 학교 컴퓨터에서 설치와 저장이 모두 막히면 허가된 원격 Mac을 검토합니다.
• 원격 연결 뒤 파일이 사라지거나 명령이 재현되지 않으면 대여를 결정하기 전에 보존 조건을 다시 확인합니다.

자주 묻는 내용

uv가 pip를 대신할 수 있나요?

새 프로젝트에서는 uv가 의존성 설치와 프로젝트 실행을 함께 관리할 수 있습니다. 하지만 pip 명령과 requirements.txt가 수업의 제출 기준이라면 완전한 대체를 시도하지 않는 편이 안전합니다. 복사한 연습 프로젝트에서 동일한 실행 결과를 확인한 뒤 선택하세요.

Mac 초보자는 어떻게 Python 3.14 가상 환경을 만드나요?

공식 설치 문서에 따라 uv를 준비한 뒤 새 폴더에서 프로젝트를 초기화합니다. 이후 Python 3.14를 선택하고 가상 환경을 만든 다음 uv run으로 코드를 실행합니다. 시스템 Python을 수정하지 않고 프로젝트 폴더 안에서 작업하는 것이 핵심입니다.

학교 컴퓨터에 관리자 권한이 없으면 어떻게 하나요?

먼저 사용자 폴더 설치와 터미널 사용이 학교 규정상 허용되는지 확인해야 합니다. 허용되지 않는다면 정책을 우회하지 말고 브라우저 실습, 이미 설치된 Python, 허가된 원격 Mac 중 가능한 경로를 선택하세요. 개인 계정과 과제 파일은 공용 컴퓨터에 남기지 않아야 합니다.

원격 Mac에서 Python을 공부해도 괜찮나요?

단기 수업이나 macOS가 필요한 과제에는 선택지가 될 수 있습니다. 개발 도구와 프로젝트 파일을 원격 Mac에 두고, 접속하는 컴퓨터에는 민감한 파일을 저장하지 않는 방식이 적합합니다. 다만 연결 안정성과 파일 보존을 먼저 시험해야 합니다.

기존 Python 프로젝트를 uv로 옮겨야 하나요?

새 프로젝트라면 uv를 우선 검토할 수 있지만, 이미 제출 절차가 정해진 프로젝트는 먼저 유지하세요. 프로젝트를 복사하고 Python 버전, 패키지 목록, 실행 명령을 기록한 뒤 단계적으로 옮겨야 합니다. 실행 한 번만 성공한 상태를 완전한 이전으로 판단하면 안 됩니다.

현재 장비에서 새 연습 프로젝트가 계속 재현된다면 굳이 원격 환경을 추가할 필요는 없습니다. 반대로 학교 컴퓨터는 설치 권한이 없고, 수업 기간 동안 안정적인 macOS 작업 공간이 필요하다면 기존 장비는 공용 접속과 파일 이동에 의존하게 되고, 환경이 초기화되거나 패키지 설치가 막히는 문제가 반복될 수 있습니다. 이 조건에서는 VPSMAC의 Mac 대여 사용 안내를 확인해 원격 Mac을 짧게 사용해 보는 편이 현실적입니다. 다만 장기간 고정 작업이나 물리 장치 연결이 필요하다면 직접 보유한 Mac이 더 적합합니다.