WSL 기능 활성 여부 확인
Win 키 + R → CMD [터미널 실행]
wsl --version [버전 확인] 커널 버전, WSLg 버전 표시
설치가 되지 않은 경우 :
'wsl'은(는) 내부 또는 외부 명령, 실행할 수 있는 프로그램, 또는 배치 파일이 아닙니다.설치가 된 경우 :
WSL 버전: 2.2.4.0
커널 버전: 5.15.153.1-2
WSLg 버전: 1.0.61
MSRDC 버전: 1.2.5326
Direct3D 버전: 1.611.1-81528511
DXCore 버전: 10.0.26091.1-240325-1447.ge-release
Windows 버전: 10.0.22631.4037설치가 된 경우 리눅스 배포판 목록 보기
wsl -l -v 또는 wsl --list --verbose
- wsl: Windows Subsystem for Linux
- -l or --list: 설치된 Linux 배포판 목록 보기
- -v or --verbose: 상세 정보 표시 (상태, 버전 포함)
출력 예시
NAME STATE VERSION
* Ubuntu-22.04 Running 2
docker-desktop Running 2
docker-desktop-data Stopped 2- NAME: 설치된 Linux 배포판 이름 (* 표시는 기본(default) 배포판)
- STATE: 현재 실행 상태
Running(실행 중),Stopped(정지됨) - VERSION:
1 (WSL1 사용 중),2 (WSL2 사용 중)
Windows 기능 켜기/끄기 설정
Windows 기능 켜기/끄기 실행
제어판 → 프로그램 및 기능 → [왼쪽 메뉴] Windows 기능 켜기/끄기
또는
Win키 → 검색 → Windows 기능 켜기/끄기
목록 체크
아래 3가지가 체크가 되어 있는지 확인
[✓] Linux용 Windows 하위 시스템 (Windows Subsystem for Linux)
[✓] 가상 머신 플랫폼 (Virtual Machine Platform)
[✓] Windows 하이퍼바이저 플랫폼 (선택 사항이지만 체크 권장)하드웨어 가상화 활성화 여부 확인
1. Ctrl + Shift + Esc 를 눌러 작업 관리자 열기
2. [왼쪽 메뉴] 성능 탭 클릭
3. CPU 항목 선택
4. [오른쪽 아래] 가상화: '사용'으로 되어 있는지 확인'사용 안 함' 으로 되어 있다면?
BIOS/UEFI 가상화 활성화
PC 재부팅 후 BIOS/UEFI 진입 (보통 F2, F12, Del 키)
CPU 설정(Advanced, CPU Configuration 등)에서 다음 항목을 'Enabled'로 변경
Intel: Intel Virtualization Technology, VT-x, VMX 등
WSL 설치 및 배포판 세팅
🔗마이크로소프트 가이드 WSL을 사용하여 Windows에 Linux를 설치하는 방법
WSL 기본 설치
wsl --install 명령어 입력 (관리자 권한) → PC 재부팅
WSL 기능은 켜져 있는데 배포판이 없다면 (나의 케이스)
목록 확인
wsl --list --online or wsl -l -o
결과
다음은 설치할 수 있는 유효한 배포판 목록입니다.
'wsl.exe --install <Distro>'를 사용하여 설치합니다.
NAME FRIENDLY NAME
Ubuntu Ubuntu
Debian Debian GNU/Linux
kali-linux Kali Linux Rolling
Ubuntu-20.04 Ubuntu 20.04 LTS
Ubuntu-22.04 Ubuntu 22.04 LTS
Ubuntu-24.04 Ubuntu 24.04 LTS
OracleLinux_7_9 Oracle Linux 7.9
OracleLinux_8_10 Oracle Linux 8.10
OracleLinux_9_5 Oracle Linux 9.5
openSUSE-Leap-15.6 openSUSE Leap 15.6
SUSE-Linux-Enterprise-15-SP6 SUSE Linux Enterprise 15 SP6
openSUSE-Tumbleweed openSUSE Tumbleweed특정 버전(Ubuntu 24.04) 설치
wsl --install -d Ubuntu-24.04
설치 및 유저네임 패스워드 설정
C:\Users\jaiden>wsl -i -d Ubuntu-24.04
잘못된 명령줄 인수: -i
지원되는 인수 목록을 가져오려면 'wsl.exe --help'를 사용하세요.
C:\Users\jaiden>wsl --install -d Ubuntu-24.04
설치 중: Ubuntu 24.04 LTS
Ubuntu 24.04 LTS이(가) 설치되었습니다.
Ubuntu 24.04 LTS을(를) 시작하는 중...
Installing, this may take a few minutes...
Please create a default UNIX user account. The username does not need to match your Windows username.
For more information visit: https://aka.ms/wslusers
Enter new UNIX username: jaiden-linux
New password: ✅패스워드
Retype new password: ✅패스워드 재입력
passwd: password updated successfully
Installation successful!
To run a command as administrator (user "root"), use "sudo <command>".
See "man sudo_root" for details.
Welcome to Ubuntu 24.04.1 LTS (GNU/Linux 5.15.153.1-microsoft-standard-WSL2 x86_64)
* Documentation: https://help.ubuntu.com
* Management: https://landscape.canonical.com
* Support: https://ubuntu.com/pro
System information as of Wed Jan 28 12:07:45 KST 2026
System load: 0.25 Processes: 45
Usage of /: 0.1% of 1006.85GB Users logged in: 0
Memory usage: 6% IPv4 address for eth0: 172.17.60.74
Swap usage: 0%
This message is shown once a day. To disable it please create the
/home/jaiden-linux/.hushlogin file.
jaiden-linux@DESKTOP-TPMO2QL:~$리눅스 배포판 설치 후 업데이트
터미널을 열고 다음 명령어로 패키지 목록을 업데이트하고 필수 패키지를 설치한다.
sudo apt update && sudo apt upgrade
또는
sudo apt update && sudo apt upgrade -y
# 중간에 "Do you want to continue? [Y/n] Y"라고 물어볼 때 자동으로 Yes라고 대답해주는 옵션리눅스 명령어
시스템 관리 필수 명령어
sudo apt update: 설치 가능한 패키지 리스트를 최신화sudo apt upgrade -y: 실제로 설치된 프로그램들을 최신 버전으로 업그레이드clear: 지저분해진 터미널 화면을 깨끗하게 비움 (Ctrl + L단축키로도 가능)
파일 및 디렉토리 탐색
ls -al: 현재 폴더의 모든 파일 목록을 보기 (숨겨진 파일까지 상세히)
pwd: 현재 작업 중인 경로를 보여준다.
cd ~: 어디에 있든 내 홈 디렉토리(/home/jaiden-linux)로 즉시 돌아간다.
mkdir 폴더명: 새로운 폴더를 만든다.
🕵️ 윈도우와 WSL 사이의 (윈도우 도구 호출)
explorer.exe .: (점 포함) 현재 리눅스 경로를 윈도우 파일 탐색기로 연다. 리눅스 파일을 윈도우로 옮길 때 좋다.code .: 현재 폴더를 VS Code로 오픈.
시스템 상태 확인 (내 PC 자원 감시)
htop: 윈도우의 '작업 관리자' 같은 기능 CPU, RAM 사용량을 실시간 그래픽으로 보여준다. (없다면sudo apt install htop으로 설치)
df -h: 현재 리눅스 하드 디스크 용량이 얼마나 남았는지 확인
explorer.exe . 에러
jaiden-linux@DESKTOP-TPMO2QL:~$ explorer.exe .
-bash: /mnt/c/Windows/explorer.exe: cannot execute binary file: Exec format errorcannot execute binary file: Exec format error
"cannot execute binary file: Exec format error"는 ==실행하려는 프로그램이 현재 시스템의 CPU 아키텍처(예: 64-bit, ARM)나 운영체제(OS) 버전과 맞지 않을 때 발생하는 오류==로, 다른 아키텍처용으로 컴파일된 파일을 실행하려 하거나, 32-bit 파일을 64-bit 시스템에서 실행하려 할 때, 또는 Windows용 파일을 리눅스에서 실행하려 할 때 주로 발생합니다. 해결 방법은 해당 시스템에 맞는 아키텍처/OS용 파일로 교체하거나, 가상 환경(WSL, VM)을 사용하여 맞는 환경에서 실행하는 것입니다.
주요 원인
- 아키텍처 불일치: 가장 흔한 원인으로, 예를 들어 ARM(M1/M2 맥, 라즈베리 파이 등)용으로 만들어진 프로그램을 x86_64(일반 PC)에서 실행하거나 그 반대로 실행하는 경우.
- 32-bit / 64-bit 불일치: 32-bit용으로 컴파일된 프로그램을 64-bit 시스템의 32-bit 호환성 라이브러리(multiarch-support 등) 없이 실행하려 할 때 발생.
- 운영체제(OS) 불일치: Windows용 실행 파일(.exe)을 Linux/macOS 터미널에서 직접 실행하려 할 때.
- 파일 손상 또는 잘못된 파일: 다운로드 중 파일이 손상되었거나, 실행 파일이 아닌 다른 형식의 파일을 실행하려 할 때 (예: 셸 스크립트를 바이너리로 인식)
🕵️ Windows용 실행 파일을 직접 실행해서 생긴 에러 같다.
상호운용성(Interop) 설정 강제 활성화
우분투 터미널에서
sudo nano /etc/wsl.conf입력 후 아래의 화면이 나온다.
GNU nano 7.2 /etc/wsl.conf
[boot]
systemd=true
#아래 내용 추가
[interop]
enabled=true
appendWindowsPath=true
[ Read 6 lines ]
^G Help ^O Write Out ^W Where Is ^K Cut ^T Execute ^C Location M-U Undo
^X Exit ^R Read File ^\ Replace ^U Paste ^J Justify ^/ Go To Line M-E Redo[interop]
enabled=true
appendWindowsPath=true저장 후 나가기: Ctrl + O 누르고 Enter (저장), 이어서 Ctrl + X (나가기).
WSL 완전히 재시작: * 중요: 우분투 터미널을 끄고, Windows PowerShell을 열어서 아래 명령어를 입력
wsl --shutdown다시 리눅스 우분투 터미널로 이동
wsl -d Ubuntu-24.04 -u jaiden-linux만약
jaiden-linux@DESKTOP-TPMO2QL:/mnt/c/Users/...$
경로가 윈도우 C드라이브 경로로 되어 있다면 cd ~ 우분투 홈으로 이동
다시 explorer.exe .로 하니 우분투 경로로 탐색기가 잘 열린다.
