개발 환경 설정 기초집LESSON 20

최종 실습: 웹·Python·Java·Unity·Unreal 개발 환경 점검표 완성하기

난이도입문

예상 시간90분

선수지식1~19강 중 사용하는 환경

20강. 최종 실습: 웹·Python·Java·Unity·Unreal 개발 환경 점검표 완성하기

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

각 도구를 한 번씩 확인했지만 새 PC나 재설치 상황에서 무엇을 어떤 순서로 준비해야 할지 기록이 없습니다. 개인 환경을 다시 만들 수 있는 최종 점검표를 완성합니다.

2. 학습 목표

3. 핵심 개념

환경 점검은 “설치됨” 체크가 아니라 명령 → 실제 경로 → 버전 → 프로젝트 실행 결과의 증거를 남기는 과정입니다. 모든 언어와 엔진을 억지로 설치할 필요는 없으며 현재 학습하는 도구는 실제 실행하고 나머지는 미설치/불필요로 명확히 기록합니다.

4. 단계별 실습

4-1. 읽기 전용 도구 감사

PowerShell · 파일 경로: D:\Dev\environment-notes\environment-audit.ps1

environment-audit.ps1
$toolChecks = @(
    @{ Name = 'Python'; Command = 'python'; VersionArgs = @('--version') },
    @{ Name = 'Java'; Command = 'java'; VersionArgs = @('--version') },
    @{ Name = 'Java compiler'; Command = 'javac'; VersionArgs = @('--version') },
    @{ Name = 'Node.js'; Command = 'node'; VersionArgs = @('--version') },
    @{ Name = 'npm'; Command = 'npm.cmd'; VersionArgs = @('--version') },
    @{ Name = 'Git'; Command = 'git'; VersionArgs = @('--version') },
    @{ Name = 'VS Code'; Command = 'code'; VersionArgs = @('--version') }
)

$report = foreach ($check in $toolChecks) {
    $command = Get-Command $check.Command -ErrorAction SilentlyContinue
    if ($command) {
        $versionArguments = [string[]]$check.VersionArgs
        $version = (& $command.Source @versionArguments 2>&1 | Select-Object -First 1)
        [PSCustomObject]@{
            Tool = $check.Name
            Status = 'Installed'
            Version = "$version"
            Path = $command.Source
        }
    } else {
        [PSCustomObject]@{
            Tool = $check.Name
            Status = 'Not found'
            Version = ''
            Path = ''
        }
    }
}

$report | Format-Table -AutoSize
$report | Export-Csv '.\environment-audit.csv' -NoTypeInformation -Encoding utf8

PowerShell · 실행 위치: D:\Dev\environment-notes

Get-Location
Get-ChildItem -Force
.\environment-audit.ps1
Get-Content .\environment-audit.csv

예상 결과: 설치된 도구는 버전과 실제 경로, 없는 도구는 Not found로 기록됩니다. 실행 정책이 스크립트를 막으면 내용을 현재 PowerShell에 선택 실행하거나 정책을 바꾸지 않고 명령을 개별 실행합니다. 관리자 권한은 필요하지 않습니다.

4-2. 편집기와 로컬 프로젝트 실행

PowerShell · 실행 위치: 선택한 프로젝트 루트

code .
Get-Location
Get-ChildItem -Force

VS Code 통합 터미널이 같은 루트를 가리키는지 확인합니다.

웹 또는 Python 중 하나를 실제 실행합니다.

# Python을 선택한 경우: 현재 폴더를 로컬 웹으로 제공
python -m http.server 8000 --bind 127.0.0.1

# 기존 Node 웹 프로젝트를 선택한 경우: package.json의 실제 script 사용
npm.cmd install
npm.cmd run dev

예상 결과: 터미널이 출력한 localhost URL을 브라우저에서 열 수 있습니다. 기존 Node 프로젝트에서만 문서화된 npm script를 사용하며, 종료는 Ctrl+C입니다.

4-3. 게임 엔진 검증

Unity 선택: ProjectVersion과 설치 Editor가 맞고 Scene이 열리며 Play Mode가 시작·종료된다.
Unreal 선택: .uproject의 EngineAssociation과 설치 Engine이 맞고 C++ 프로젝트가 Development Editor로 컴파일되며 PIE가 실행된다.
두 엔진 중 현재 학습하는 하나는 반드시 실제 결과를 확인한다.

4-4. 충돌 재현과 해결 기록

PATH 누락을 실제 시스템에서 만들지 말고, 잘못된 실행 경로·포트 충돌·프로젝트 요구 버전 불일치처럼 되돌리기 쉬운 사례 하나를 선택합니다.

environment-issue-record.md
# Issue record
- Symptom and expected result:
- Reproduction command and working directory:
- Tool version and executable path:
- First error message:
- Root cause:
- One change applied:
- Retest result:
- Date resolved:

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

감사 스크립트는 Get-Command가 선택한 실제 실행 파일에 직접 version 인자를 전달하고 결과를 CSV로 남깁니다. 프로젝트 실행과 엔진 검증을 별도로 수행해 “명령이 있음”과 “프로젝트가 동작함”을 구분합니다.

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

7. 직접 실습

개인 개발 환경 최종 점검표

완성 파일은 environment-audit.csv, development-environment-checklist.md, environment-issue-record.md 세 개입니다. 버전 업데이트나 새 프로젝트 시작 때 날짜와 검증 결과를 갱신합니다.

8. 이해 점검 질문 3개

9. 핵심 요약

MINI QUIZ