Windows 11에서 Ubuntu와 GCC 시작하기

STEP 01시작 전 확인

WSL은 Windows에서 리눅스 환경을 실행하는 기능입니다. Ubuntu는 여기에 설치할 리눅스 배포판이며, GCC는 Ubuntu 안에서 사용할 컴파일러입니다.

• Windows 11 PC, 인터넷 연결, Windows 관리자 권한을 준비합니다.
• 진행 중인 작업을 저장합니다. 설치 중 재부팅이 필요할 수 있습니다.
• 작업 관리자 → 성능 → CPU에서 가상화: 사용 여부를 확인합니다. 꺼져 있다면 PC 제조사의 BIOS/UEFI 안내를 확인하세요.

STEP 02WSL 2와 Ubuntu 설치

교수님이 추천한 설치 안내는 위키독스 「2.2. WSL 설치와 실행」입니다. 아래 설치 명령은 이 자료에서 사용하는 Ubuntu 22.04 기준입니다. 수업에서 지정한 버전이 있으면 그 버전을 사용하세요.

① 먼저 설치 상태 확인

wsl --version
wsl --status
wsl -l -v

② 설치할 배포판 선택

시작 메뉴에서 PowerShell을 검색해 관리자 권한으로 실행합니다. 먼저 온라인 목록에 원하는 배포판 이름이 있는지 확인하세요.

wsl --list --online

Ubuntu가 없으면 아래 명령으로 설치합니다. 수업에 맞는 Ubuntu가 이미 등록되어 있으면 해당 배포판을 사용하세요.

wsl --install -d Ubuntu-22.04

재부팅 안내가 나오면 작업을 저장하고 Windows를 재부팅합니다. 이후 시작 메뉴에서 Ubuntu 22.04를 열거나 아래 명령으로 실행하고, STEP 03의 사용자 계정을 만듭니다.

wsl -d Ubuntu-22.04

WSL 버전이 정상 출력된다면 Ubuntu 배포판 설치부터 진행할 수 있습니다.

최신 WSL의 커널은 WSL 업데이트로 관리하므로 별도의 구형 커널 패키지 설치부터 시작할 필요는 없습니다.

WSL 2 사용 여부 확인

wsl -l -v

목록에서 Ubuntu-22.04 행의 VERSION이 2인지 확인합니다. Stopped는 종료된 상태라는 뜻이며 오류가 아닙니다.

Ubuntu나 Ubuntu-24.04처럼 다른 이름이 표시되면 이후 명령의 Ubuntu-22.04 자리에 실제 등록된 이름을 사용하세요.

VERSION이 1인 경우에만 다음 명령을 실행합니다. 기존 배포판에 중요한 파일이 있다면 먼저 백업하세요.

wsl --set-version Ubuntu-22.04 2

설치 및 WSL 버전 확인: Microsoft WSL 설치 문서

STEP 02-1WSL 1·2에서 Ubuntu 실행하기

Ubuntu를 처음 열거나 PC 재시작 후 다시 실습할 때는 아래 순서를 따릅니다. 명령을 입력할 Ubuntu 터미널(Bash)이 열리며, Ubuntu 바탕화면은 표시되지 않습니다.

① PowerShell에서 설치된 Ubuntu 이름 확인

Windows 시작 메뉴에서 PowerShell을 열고 아래 명령을 한 줄씩 실행합니다. 일반적인 Ubuntu 실행에는 관리자 권한이 필요하지 않습니다.

wsl --version
wsl --status
wsl -l -v

wsl --version은 WSL 구성 요소 버전, wsl --status는 기본 설정을 보여 줍니다. 설치된 Ubuntu의 이름과 WSL 1·2 여부는 마지막 목록의 NAME과 VERSION에서 확인합니다.

  NAME             STATE           VERSION
* Ubuntu-22.04     Stopped         2

이 예시의 배포판 이름은 Ubuntu-22.04, 실행 방식은 WSL 2입니다. *는 기본 배포판이고, Stopped는 현재 멈춘 상태이며, 실행 명령을 입력하면 시작됩니다. Running이면 이미 실행 중입니다. 실제 이름이 Ubuntu 또는 Ubuntu-24.04라면 아래 모든 PowerShell 예제의 Ubuntu-22.04를 그 이름으로 바꾸세요.

목록에 Ubuntu가 없다면 STEP 02의 배포판 설치를 먼저 진행하세요. VERSION이 1이어도 실행 방법은 같으며, WSL 2로 전환하려면 STEP 02의 버전 확인 안내를 따릅니다. 기본 버전이 2라는 설정만으로 기존 Ubuntu가 WSL 2로 바뀌지는 않습니다.

② 이름을 지정해 Ubuntu 열기

같은 PowerShell 창에서 실행합니다. -d는 실행할 배포판을 지정합니다. 기본 배포판이 다른 리눅스여도 지정한 Ubuntu가 열립니다.

wsl -d Ubuntu-22.04

최초 실행에서 사용자 이름과 비밀번호를 요청하면 STEP 03의 계정 생성 안내를 따라 설정합니다. 이미 계정을 만들었다면 보통 그 사용자로 바로 들어갑니다.

성공하면 같은 창에 다음과 비슷한 프롬프트가 표시됩니다. 사용자 이름·PC 이름·현재 경로는 환경마다 다릅니다.

student@MY-PC:~$

③ Ubuntu 안에 들어왔는지 확인

이제 아래 명령은 Ubuntu · Bash에서 실행합니다. PowerShell에서 열면 시작 위치가 Windows 폴더에 대응하는 /mnt/c/...일 수 있습니다. 먼저 cd ~로 Linux 홈 폴더로 이동합니다.

cd ~
whoami
pwd
cat /etc/os-release

출력은 순서대로 Linux 사용자 이름, /home/사용자명 경로, NAME="Ubuntu" 등이 포함된 배포판 정보입니다. Ubuntu 버전과 WSL 실행 방식(VERSION 1·2)은 별개입니다.

처음 설정 중이라면 STEP 03으로, 설정을 마쳤다면 작업 폴더로 이어가세요.

④ 시작 메뉴나 Windows Terminal로 열기

• 시작 메뉴: 설치한 Ubuntu 앱(예: Ubuntu 22.04)을 검색해 엽니다.
• Windows Terminal: 새 탭 버튼 옆의 메뉴에서 Ubuntu 프로필을 선택합니다. 목록에 없으면 PowerShell 탭에서 ②의 명령을 실행하세요.
• 네트워크 실습용 터미널 두 개: PowerShell 탭 두 개에서 같은 배포판 이름으로 ②의 명령을 실행합니다. 한 창에서는 서버를, 다른 창에서는 클라이언트를 실행합니다.

⑤ 기본 Ubuntu를 짧은 명령으로 열기 · 선택

wsl만 입력하면 기본 배포판이 열립니다. 항상 이 Ubuntu가 열리게 하려면 새 PowerShell 탭에서 아래 설정을 한 번 실행하세요. 기본 배포판 선택을 변경하는 명령이며 WSL 1·2를 바꾸지는 않습니다.

wsl --set-default Ubuntu-22.04

그다음부터 PowerShell에서 아래 명령으로 기본 Ubuntu의 홈 폴더를 바로 열 수 있습니다.

wsl ~

⑥ 종료하고 다음에 다시 실행하기

Ubuntu에서 작업을 저장한 뒤 아래 명령으로 현재 셸을 닫습니다. PowerShell에서 들어왔다면 PowerShell로 돌아가며, Ubuntu 전용 탭은 닫힐 수 있습니다.

exit

다음 실습 때는 PowerShell에서 wsl -d Ubuntu-22.04를 실행하고, Ubuntu 안에서 cd ~/projects/network-practice로 이동하세요. 이 폴더를 아직 만들지 않았다면 STEP 04를 먼저 진행합니다. 매번 설치하거나 계정을 다시 만들 필요는 없습니다.

실행 명령과 계정 설정: Microsoft WSL 기본 명령 · Microsoft 계정 및 터미널 설정

STEP 03Ubuntu 계정과 패키지 준비

Ubuntu 최초 실행 시 소문자 영문으로 사용자 이름을 정하고 비밀번호를 두 번 입력합니다. Windows 로그인 계정과 별개이며, 비밀번호를 입력해도 문자나 별표가 표시되지 않습니다.

① Ubuntu에서 sudo 확인

계정 생성이 끝나면 Ubuntu 터미널에서 아래 명령을 실행하고 방금 만든 Ubuntu 비밀번호를 입력합니다.

whoami
sudo whoami

첫 번째 명령은 현재 사용자 이름을, 두 번째 명령은 아래의 관리자 계정 이름을 출력합니다.

root

② 패키지 업데이트

sudo가 정상 동작하면 같은 Ubuntu 터미널에서 실행합니다. GCC와 GDB는 STEP 05에서 설치합니다.

sudo apt update
sudo apt upgrade
sudo apt install git curl nano

sudo는 관리자 권한으로 명령을 실행합니다. apt update는 패키지 목록을 갱신하고, apt upgrade는 설치된 패키지를 업데이트합니다. 계속할지 묻는 메시지가 나오면 내용을 확인하고 Y를 입력합니다.

계정과 초기 환경: Microsoft 개발 환경 설정

STEP 04리눅스 작업 폴더 만들기

리눅스 도구로 빌드할 코드는 파일 접근 성능을 위해 Ubuntu 홈 폴더 아래에 둡니다. ~는 현재 사용자의 홈 디렉터리입니다.

mkdir -p ~/projects/network-practice
cd ~/projects/network-practice
pwd

출력은 /home/사용자명/projects/network-practice 형태입니다. Windows 폴더에는 다음처럼 접근합니다.

ls /mnt/c/Users/USER/Desktop/Network_Programing

Ubuntu의 현재 폴더를 Windows 탐색기로 열려면 explorer.exe .를 실행합니다. 이 가이드의 C 실습은 ~/projects/network-practice에서 진행합니다.

파일 위치와 Windows 연동: Microsoft 파일 시스템 안내

STEP 05GCC 설치와 첫 C 프로그램

① 컴파일러와 빌드 도구 설치

sudo apt update
sudo apt install build-essential gdb
gcc --version
g++ --version
make --version
gdb --version
command -v gcc

build-essential은 GCC, G++, Make와 기본 개발 헤더 등을 설치합니다. gdb는 디버거입니다.

버전 번호는 Ubuntu 버전에 따라 다르며, 기본 구성에서 GCC 경로는 보통 /usr/bin/gcc입니다.

② 소스 파일 작성

cd ~/projects/network-practice
nano hello.c

아래 코드를 편집기에 붙여 넣습니다. Ctrl + O → Enter로 저장하고 Ctrl + X로 닫습니다.

#include <stdio.h>

int main(void)
{
    int port = 9000;
    printf("Hello, Ubuntu! Port: %d\n", port);
    return 0;
}

③ 컴파일하고 실행

gcc -std=c17 -Wall -Wextra -Wpedantic -g -O0 hello.c -o hello
./hello

컴파일에 성공한 뒤 실행하면 아래 문장이 출력됩니다. 컴파일 오류가 있으면 먼저 해결하세요.

Hello, Ubuntu! Port: 9000

④ 여러 파일 / C++를 빌드할 때

해당 소스 파일이 있을 때는 아래 명령을 사용합니다. C++ 빌드에는 표준 라이브러리도 링크하는 g++를 사용합니다.

# C 소스 파일이 main.c, helper.c인 경우
gcc -std=c17 -Wall -Wextra -g main.c helper.c -o app

# C++ 소스 파일이 main.cpp인 경우
g++ -std=c++17 -Wall -Wextra -g main.cpp -o cpp-app

일반적인 Linux 소켓 API는 추가 Winsock 라이브러리 없이 사용합니다. POSIX 스레드를 사용하는 코드에는 -pthread 옵션을 추가합니다.

설치: VS Code 공식 WSL GCC 가이드 · 경고 옵션: GCC 공식 문서

STEP 06GDB로 실행 흐름 살펴보기

앞에서 -g -O0로 빌드한 hello를 사용합니다.

cd ~/projects/network-practice
gdb ./hello

(gdb) 프롬프트가 나오면 아래 명령을 한 줄씩 입력합니다.

break main
run
next
print port
continue
quit

break main은 main 함수에 중단점을 설정합니다. run으로 시작하고, 변수 초기화 줄에서 next를 실행한 뒤 print port로 값 9000을 확인합니다.

continue는 계속 실행하고 quit는 GDB를 종료합니다.

STEP 07VS Code에서 편집하기 · 선택

1. Windows에 VS Code를 설치합니다.
2. VS Code 확장 화면에서 Microsoft의 WSL 확장을 설치합니다.
3. Ubuntu에서 아래 명령으로 프로젝트를 엽니다.

cd ~/projects/network-practice
code .

최초 연결에는 VS Code 서버 다운로드가 필요할 수 있습니다. 창 왼쪽 아래에 WSL: Ubuntu가 표시되는지 확인하고, 확장 화면에서 Microsoft의 C/C++ 확장을 WSL 환경에 설치합니다.

VS Code의 터미널 → 새 터미널에서 command -v gcc를 실행해 리눅스 컴파일러 경로를 확인하세요.

hello.c를 열고 터미널에서 STEP 05의 GCC 명령으로 빌드합니다. IntelliSense에서 컴파일러 경로를 요구하면 /usr/bin/gcc를 지정합니다.

편집기 연결과 C/C++ 설정: VS Code 공식 WSL 튜토리얼

STEP 08자주 쓰는 리눅스 명령

Tab으로 자동완성, ↑로 이전 명령 불러오기, Ctrl + C로 실행 중단이 가능합니다. 리눅스는 파일명의 대소문자를 구분합니다.

개인 셸 설정

nano ~/.bashrc로 파일을 열고 아래 한 줄을 추가하면 ll을 목록 조회 명령으로 쓸 수 있습니다.

alias ll='ls -alF'

저장 후 Ubuntu에서 source ~/.bashrc를 실행하면 현재 셸에 반영됩니다.

STEP 09로컬 TCP 연결 실습 · 선택

sudo apt install iproute2 iputils-ping dnsutils netcat-openbsd
ip addr
ip route
ss -lnt

Ubuntu 터미널을 두 개 엽니다. 같은 Ubuntu 배포판 안에서 서버와 클라이언트를 실행합니다.

nc -l 127.0.0.1 9000

nc 127.0.0.1 9000

한쪽에서 문장을 입력하고 Enter를 누르면 반대쪽에 표시됩니다. 127.0.0.1은 자신의 루프백 주소, 9000은 포트입니다. 종료는 Ctrl + C입니다.

외부 PC와 연결하는 구성은 WSL 네트워크 모드와 방화벽에 따라 별도 설정이 필요합니다.

STEP 10막혔을 때 확인할 것

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

wsl --update
wsl --shutdown
wsl -d Ubuntu-22.04

관련 문서: 설치 문제 · WSL 관리 명령

STEP 11환경 설정 완료 체크

직접 확인한 항목에 체크하세요. 체크 상태는 현재 페이지를 열어 둔 동안 유지됩니다.