2강. Windows 개발 폴더 구조: 프로젝트를 어디에 두어야 안전할까?

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

프로젝트를 Program Files, 바탕 화면 동기화 폴더 또는 지나치게 긴 경로에 두면 권한·잠금·경로 길이 문제를 만나기 쉽습니다. 작업 위치를 의도적으로 정합니다.

✓2. 학습 목표

✓이 강의를 마치면

• 프로젝트 루트와 도구 설치 경로를 구분합니다.
• 일반 사용자에게 쓰기 가능한 개발 폴더를 만듭니다.
• 절대 경로와 상대 경로를 확인합니다.

◇3. 핵심 개념

프로젝트 폴더는 직접 만든 소스와 설정을 보관하는 작업 공간입니다. 도구가 설치되는 Program Files와 섞지 않습니다. 공백과 한글 경로를 지원하는 도구가 많지만, 오래된 빌드 도구까지 고려하면 D:\Dev\project-name처럼 짧은 영문 경로가 문제를 줄입니다.

경로에는 두 표현이 있습니다. D:\Dev\environment-lab은 드라이브부터 모두 적은 절대 경로이고, 현재 위치가 D:\Dev일 때의 .\environment-lab은 상대 경로입니다. 상대 경로는 현재 위치가 바뀌면 다른 대상을 가리키므로 파일 명령 전에는 Get-Location으로 기준을 확인합니다.

위치	프로젝트에 적합한가	이유
D:\Dev 또는 C:\Dev	적합	짧고 일반 사용자 권한으로 관리하기 쉽습니다.
C:\Program Files	부적합	설치 프로그램 영역이라 쓰기에 관리자 권한이 필요할 수 있습니다.
바탕 화면·문서의 동기화 폴더	상황에 따라 다름	동기화 잠금과 대형 캐시 업로드가 빌드에 영향을 줄 수 있습니다.
드라이브 루트 전체	부적합	프로젝트 경계가 불명확하고 실수의 영향 범위가 커집니다.

✎4. 단계별 실습

명령 목적: 쓰기 가능한 개발 루트와 과정 전용 실습 폴더를 만들고 실제 절대 경로를 확인합니다.

실행 전 상태: 일반 PowerShell을 열고 Test-Path -LiteralPath 'D:\'로 D: 드라이브 존재 여부를 확인합니다. 없다면 아래 $devRoot만 C:\Dev로 바꿉니다. 기존 프로젝트 폴더를 이동하거나 삭제하는 실습이 아닙니다.

PowerShell · 시작 위치: 어느 위치여도 되지만 첫 명령 전에 Get-Location을 기록합니다.

$devRoot = 'D:\Dev'
Get-Location
New-Item -ItemType Directory -Force -Path $devRoot
Set-Location -LiteralPath $devRoot
New-Item -ItemType Directory -Force -Path '.\environment-lab'
Resolve-Path -LiteralPath '.\environment-lab'
Get-ChildItem -Force

예상 결과: Resolve-Path가 D:\Dev\environment-lab을 표시하고 마지막 목록에 environment-lab이 보입니다. 이미 폴더가 있어도 -Force는 폴더 자체를 삭제하거나 비우지 않습니다. D: 드라이브가 없다면 C:\Dev를 사용하며 관리자 권한은 필요하지 않습니다.

권장 구조:

D:\Dev\
├─ learning\
├─ web\
├─ python\
├─ unity\
├─ unreal\
└─ environment-notes\

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

Set-Location은 이후 상대 경로의 기준을 바꾸고 Resolve-Path는 실제 절대 경로를 보여 줍니다. -LiteralPath는 대괄호 같은 문자를 와일드카드로 해석하지 않아 사용자가 정한 경로를 그대로 다룹니다.

실행 흐름은 개발 루트 선택 → 폴더 생성 → 현재 위치 변경 → 실습 폴더 생성 → 절대 경로와 목록 검증 순서입니다. 명령이 성공했다는 문장만 믿지 말고 Resolve-Path와 Get-ChildItem로 결과를 확인합니다.

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

!자주 하는 실수

• Program Files 안에 프로젝트 생성: 프로그램 설치 영역과 사용자 소스 영역을 분리합니다.
• OneDrive 동기화 중 대형 엔진 캐시 저장: 잠금·용량 정책을 확인하고 소스와 생성 캐시 위치를 구분합니다.
• 경로를 문자열 결합으로 추측: Resolve-Path와 Test-Path로 실제 위치를 확인합니다.
• 기존 폴더를 옮기기 전 엔진 프로젝트를 열어 둠: 프로그램을 닫고 백업한 뒤 경로 의존 설정을 확인합니다.

✎7. 직접 실습

✎직접 실습

실습 목표

일반 사용자 권한으로 쓸 수 있는 개발 루트에 분야별 폴더를 만들고, 상대 경로와 절대 경로를 구분합니다.

시작 전 상태

사용할 드라이브에 최소한 C:\Dev 또는 D:\Dev를 만들 권한이 있는지 확인합니다. 이 실습에서는 기존 폴더를 이동·삭제하지 않습니다.

1단계: 따라 하기

강의 예제대로 environment-lab을 만들고 Resolve-Path 결과와 Get-ChildItem -Force 목록을 기록합니다.

2단계: 경로 바꿔 보기

자신이 실제로 사용할 개발 루트로 $devRoot 값만 바꿔 실행합니다. Set-Location 전후의 Get-Location 결과가 어떻게 달라지는지 비교합니다.

3단계: 직접 적용

web, python, unity, unreal, environment-notes를 개발 루트 아래 만듭니다. 각 절대 경로와 동기화·관리자 권한 개입 여부를 표로 정리합니다.

4단계: 스스로 확인

• 모든 폴더가 선택한 개발 루트 안에 있나요?
• Program Files나 동기화 폴더에 생성하지 않았나요?
• 현재 위치가 달라져도 절대 경로로 같은 대상을 확인할 수 있나요?

막혔을 때

증상	원인	확인·해결
드라이브를 찾을 수 없음	D: 드라이브가 없음	$devRoot를 C:\Dev로 바꿉니다.
접근 거부	보호된 폴더를 선택함	관리자 창을 열기보다 사용자 쓰기 가능한 개발 루트를 선택합니다.
Resolve-Path 실패	아직 폴더가 없거나 철자가 다름	Test-Path $devRoot와 Get-ChildItem로 단계별 확인합니다.

?8. 이해 점검 질문 3개

?이해 점검

1. Unity 프로젝트를 Program Files 아래 만들었더니 저장할 때마다 권한 오류가 납니다. 어느 종류의 경로로 옮겨야 하며 이유는 무엇인가요?
2. 같은 .\environment-lab 명령이 서로 다른 폴더를 가리킬 수 있는 이유와 실행 전 확인할 명령은 무엇인가요?
3. 동기화 폴더에서 엔진 캐시 잠금이 반복될 때 소스와 생성 캐시의 위치를 어떻게 나누어 점검하겠나요?

■9. 핵심 요약

■핵심 요약

일반 권한으로 쓸 수 있는 짧고 예측 가능한 개발 루트를 만들고 설치 파일, 소스, 생성 캐시를 구분합니다. 경로는 추측하지 않고 PowerShell로 확인합니다.

§10. 다음 강의 연결

안전한 실습 경로를 준비했습니다. 다음 강의에서는 현재 위치와 대상 파일을 확인하며 PowerShell 명령을 실행합니다.