Windows와 WSL 프로젝트#

Linux 작업 폴더를 준비해 Windows에서 연결하고 WSL 세션 변경 후 편집 내용을 보존하며 복구합니다.

프로젝트 위치 선택#

WSL 프로젝트는 선택한 배포판의 Linux 파일 시스템에 소스와 Linux 엔진 작업을 보관합니다. Windows 앱은 창·편집기·연결을 제공합니다. Windows 로컬 프로젝트는 다른 어댑터를 사용하므로 편집 전에 실행 환경을 선택하세요.

root가 아닌 기본 사용자가 있는 x86-64 Ubuntu 24.04 WSL2 배포판을 사용하세요. 프로젝트는 /home/your-user/projects/demo처럼 Linux 사용자 디렉터리에 둡니다. /mnt/c나 네트워크 공유는 이 Linux 워크스페이스 조건에 맞지 않습니다.

확인 및 연결#

Powershell
wsl --list --verbose

  1. 목록에서 사용할 배포판의 WSL 버전이 2인지 확인합니다. 앱의 프로젝트 연결이 배포판을 설치하지는 않습니다.

  2. Windows 앱에서 \\wsl.localhost\Ubuntu-24.04\home\your-user\projects\demo와 같은 WSL 경로로 Linux 프로젝트를 선택합니다.

  3. 설치된 앱에서 백엔드 준비를 제안하면 내용을 검토하고 앱에 맞는 번들 백엔드를 사용합니다. 다른 도우미 실행 파일로 직접 교체하면 호환되지 않을 수 있습니다.

  4. 배포판·사용자·프로젝트 루트·연결 상태를 확인합니다. 파일 변경 트랜잭션이나 엔진 실행 전에 작은 텍스트 파일을 열어 저장합니다.

파일·Git·엔진#

저장된 텍스트·프로젝트 설정·지원되는 소스 관리 작업은 Linux 워크스페이스를 통합니다. 저장 시 파일 버전을 확인하며 WSL 프로젝트의 Git 조회·변경은 Linux Git을 사용합니다. 연결만으로 모든 엔진·바이너리 뷰어·원격 Git 전송을 사용할 수 있는 것은 아니므로 설치된 환경의 동작 표시를 확인하세요.

변경 후 다시 연결#

변경 또는 메시지

복구 방법

WSL 재시작

저장하지 않은 내용을 보존한 뒤 명시적으로 다시 연결하고 저장 전에 파일을 다시 읽습니다.

프로젝트 폴더 이동·교체

원하는 디렉터리를 다시 엽니다. 새 폴더에 이전 연결을 그대로 사용하지 않습니다.

root 사용자·공유 권한·Windows 마운트 거부

일반 사용자가 소유한 Linux 폴더를 선택합니다.

저장 결과가 불확실함

현재 저장 내용을 다시 읽어 확인한 후 재시도 여부를 결정합니다.

패키지·백업·오류 보고 절차는 Windows 설치, 로컬 워크스페이스, 진단을 참고하세요.