본문으로 건너뛰기
개발 환경 설정 기초집LESSON 13

프로젝트별 환경 분리: 전역 설치가 항상 답이 아닌 이유

난이도입문
예상 시간40분
선수지식12강 패키지 관리자

13강. 프로젝트별 환경 분리: 전역 설치가 항상 답이 아닌 이유

1. 이번 강의에서 해결할 문제​

프로젝트 A를 위해 패키지를 업데이트했더니 프로젝트 B가 실행되지 않습니다. 컴퓨터 전체 기본값과 프로젝트별 고정 정보를 구분합니다.

2. 학습 목표​

3. 핵심 개념​

운영체제에는 여러 프로젝트가 공유할 도구가 있고, 프로젝트에는 자신의 의존성·버전 선언이 있습니다.

  • Python: .venv와 requirements 또는 pyproject
  • Node: 프로젝트 node_modules와 package-lock
  • Java: Gradle Wrapper와 toolchain 설정
  • Unity: ProjectVersion.txt와 Packages
  • Unreal: .uproject, EngineAssociation과 Source 빌드 설정

4. 단계별 실습​

PowerShell · 실행 위치: 각 프로젝트 루트

$markers = @(
    '.venv\Scripts\python.exe',
    'package.json',
    'package-lock.json',
    'gradlew.bat',
    'ProjectSettings\ProjectVersion.txt',
    'Packages\manifest.json'
)

$markers | ForEach-Object {
    [PSCustomObject]@{ Marker = $_; Exists = Test-Path -LiteralPath $_ }
}

Get-ChildItem -Filter *.uproject -ErrorAction SilentlyContinue

예상 결과: 현재 프로젝트 종류에 해당하는 Marker만 True로 표시됩니다. 관리자 권한은 필요하지 않습니다.

문서 · 파일 경로: 프로젝트 루트 ENVIRONMENT.md

ENVIRONMENT.md
# Environment
- Operating system: Windows 11
- Required runtime or engine:
- Verified version command:
- Local dependency file:
- Start command:
- Last verified date:

5. 명령어와 설정이 동작하는 이유​

Marker 파일은 다른 컴퓨터에서 어떤 도구와 의존성을 준비해야 하는지 알려 줍니다. 전역 PATH는 기본 실행 후보를 제공하지만 프로젝트 설정과 IDE가 다른 버전을 명시적으로 선택할 수도 있습니다.

6. 자주 하는 실수와 해결법​

7. 직접 실습​

8. 이해 점검 질문 3개​

9. 핵심 요약​

MINI QUIZ

프로젝트별 환경 분리: 전역 설치가 항상 답이 아닌 이유 미니 퀴즈

선택 즉시 정답과 해설을 확인할 수 있습니다. 결과는 이 브라우저에만 저장됩니다.

0 / 2
  1. 문제 1“프로젝트별 환경 분리: 전역 설치가 항상 답이 아닌 이유” 코드 리뷰에서 유지해야 할 설계 원칙은 무엇인가요?
  2. 문제 2‘전역 패키지를 업데이트해 모든 프로젝트에 적용’ 실수를 판단할 때 “프로젝트별 환경 분리: 전역 설치가 항상 답이 아닌 이유” 강의가 제시한 기준은 무엇인가요?

답을 선택하면 진행 결과가 자동으로 저장됩니다.

LESSON STATUS

학습을 마쳤나요?

직접 실습과 점검 질문까지 확인한 뒤 완료로 표시하세요.

13강. 프로젝트별 환경 분리: 전역 설치가 항상 답이 아닌 이유 미완료 상태