[Setup Log] Windows PowerShell에서 리눅스 사용하기 wsl

 

 

📘 [Setup Log] Windows PowerShell에서 리눅스 사용하기 - WSL

🛠️ 개요

WSL(Windows Subsystem for Linux)은 Windows 환경에서 리눅스 배포판을 설치하고 사용할 수 있도록 해주는 기능입니다. Git Bash보다 강력한 리눅스 환경이 필요하거나 Ubuntu 등의 배포판에서 개발하고자 할 때 유용합니다.

💡 설치 전 확인사항

• Windows 10 (버전 2004 이상) 또는 Windows 11 필요
• PowerShell을 관리자 권한으로 실행

🧩 설치 방법

wsl --install

위 명령어 하나로 WSL과 기본 Ubuntu 배포판이 자동 설치됩니다. 설치 완료 후 시스템 재시작이 필요할 수 있습니다.

📦 다른 배포판 설치

wsl --list --online
wsl --install -d Ubuntu-22.04

예: wsl --install -d Debian

⚙️ WSL 버전 확인 및 설정

wsl --list --verbose
wsl --set-version <배포판 이름> 2

WSL 2는 전체 리눅스 커널 기능을 제공하며 Docker와 호환됩니다.

📁 파일 시스템 접근

• 리눅스 홈 디렉토리: /home/사용자이름/
• Windows 경로 접근: /mnt/c/Users/사용자이름/Desktop/

🔄 PowerShell에서 리눅스 명령어 바로 사용

wsl ls -al

PowerShell에서도 WSL을 통해 리눅스 명령어를 직접 실행할 수 있습니다.

✨ Ubuntu 환경에서 oh-my-zsh 사용하기

시작 -> Ubuntu 실행 -> 계정 이름 설정 -> 비밀번호 설정

Ubuntu가 정상적으로 설치되고 실행된다면, zsh 및 oh-my-zsh와 같은 고급 셸 환경도 사용할 수 있습니다. 개발 효율성과 사용자 경험을 모두 향상시킬 수 있는 설정입니다.

설치 및 설정 방법은 아래 링크의 가이드를 참고해 주세요:

• 📘 [Setup Log] WSL Ubuntu에서 zsh + oh-my-zsh 설치 및 설정하기

---

❗ wsl 명령어가 없다고 나올 때

PowerShell에 wsl 명령어를 입력했을 때, "wsl은 인식되지 않는 명령입니다" 또는 "wsl: 명령을 찾을 수 없습니다"라는 메시지가 나온다면, 다음과 같은 원인과 해결 방법이 있습니다.

1️⃣ WSL 기능이 Windows에 설치되어 있지 않은 경우

다음 명령어를 PowerShell(관리자 권한)에서 입력하여 WSL 기능을 수동으로 활성화할 수 있습니다.

dism.exe /online /enable-feature /featurename:Microsoft-Windows-Subsystem-Linux /all /norestart
dism.exe /online /enable-feature /featurename:VirtualMachinePlatform /all /norestart

위 두 명령어를 실행한 후 컴퓨터를 재시작해 주세요.

2️⃣ Windows 버전이 너무 낮은 경우

WSL 2는 Windows 10 2004 버전 이상 또는 Windows 11에서만 지원됩니다. 아래 명령어로 현재 Windows 버전을 확인할 수 있습니다:

systeminfo | findstr /B /C:"OS Version"

출력된 버전이 10.0.19041 이상인지 확인하세요. 낮은 경우 Windows 업데이트가 필요합니다.

3️⃣ 그래도 안 될 경우: WSL 수동 설치

Microsoft에서 제공하는 WSL 설치 파일을 직접 받아 설치할 수 있습니다.

• https://aka.ms/wslinstall 에서 최신 WSL 설치 파일 다운로드
• 설치 후 PowerShell을 다시 실행해 wsl --version이 작동하는지 확인

🐧 WSL에서 apt 명령어가 안 되는 경우

WSL 설치 후 Ubuntu에 진입했는데 sudo apt update를 입력했을 때 "apt: command not found" 또는 비정상적인 오류가 발생하는 경우, 다음 원인과 해결 방법을 참고하세요.

1️⃣ apt가 없는 배포판을 설치한 경우

apt는 Ubuntu 또는 Debian 계열에서만 사용됩니다. Fedora, Alpine, Arch 등은 apt가 없으므로 다른 패키지 관리자를 사용해야 합니다.

현재 배포판 확인:

cat /etc/os-release

출력 결과가 Ubuntu 또는 Debian이 아니라면, 아래 명령어로 Ubuntu-22.04 LTS를 설치하는 것을 권장합니다:

wsl --install -d Ubuntu-22.04

2️⃣ Ubuntu 설치가 비정상적으로 된 경우

간혹 배포판 설치 도중 오류가 발생해 /etc/apt 관련 파일이 손상된 경우도 있습니다. 이럴 땐 해당 배포판을 제거하고 재설치하면 됩니다.

# 설치된 배포판 목록 보기
wsl --list --verbose

# 예: Ubuntu 제거
wsl --unregister Ubuntu

# 다시 설치
wsl --install -d Ubuntu-22.04

3️⃣ 네트워크 오류 또는 리포지토리 접근 불가

리포지토리 서버가 일시적으로 접근 불가하거나 DNS 문제로 apt update가 실패할 수 있습니다. 아래 방법으로 DNS 설정을 초기화해보세요.

sudo rm /etc/resolv.conf
echo "nameserver 8.8.8.8" | sudo tee /etc/resolv.conf

그리고 다시 sudo apt update를 시도하세요.