윈도우 11 환경에서 wsl에 설치된 우분투에 Doom Emacs 설치하는 방법

 

Windows 11의 WSL(Windows Subsystem for Linux) 우분투 환경에서 Doom Emacs를 설치하면, 윈도우 네이티브 환경보다 성능이 훨씬 뛰어나고 리눅스 패키지 생태계를 그대로 쓸 수 있어 훨씬 매끄럽게 구동됩니다.

WSL 우분투 터미널을 열고 아래 단계에 따라 설치를 진행해 보세요.

 

WSLg를 통해 윈도우 11에서 리눅스 네이티브로 구동될 Doom Emacs의 모습. 출처: Wikimedia Commons - Wikimedia.org

1 단계: 필수 시스템 패키지 및 Emacs 설치

먼저 우분투 패키지 목록을 업데이트하고, Doom Emacs 구동에 필요한 필수 의존성 도구들과 Emacs를 함께 설치합니다.

1.    WSL 우분투 터미널에서 아래 명령어를 입력합니다.

Bash

sudo apt update && sudo apt upgrade -y

sudo apt install -y emacs git ripgrep fd-find

2.    우분투에서는 fd 명령어의 패키지명이 fd-find로 등록되어 작동하므로, Doom Emacs가 fd로 바로 인식할 수 있도록 개인 바이너리 경로에 심볼릭 링크를 걸어줍니다.

Bash

mkdir -p ~/.local/bin

ln -s $(which fdfind) ~/.local/bin/fd

2 단계: Doom Emacs 소스코드 복사

XDG 표준 경로에 맞춰 Doom Emacs 소스코드를 가져옵니다.

Bash

git clone --depth 1 https://github.com/doomemacs/doomemacs ~/.config/emacs

3 단계: 환경 변수 설정 및 설치 스크립트 실행

어느 경로에서나 doom 명령어를 바로 사용할 수 있도록 PATH 환경 변수를 지정하고 설치를 시작합니다.

1.    사용 중인 쉘 설정 파일(기본적으로 .bashrc)에 doom 경로와 앞서 설정한 fd 경로를 추가합니다.

Bash

echo 'export PATH="$HOME/.config/emacs/bin:$HOME/.local/bin:$PATH"' >> ~/.bashrc

source ~/.bashrc

2.    Doom Emacs 설치 스크립트를 실행합니다.

Bash

doom install

3.    설치 과정 중 나타나는 두 질문(환경 변수 파일 생성, 폰트 다운로드)에 모두 y를 입력하고 완료될 때까지 기다립니다.

4 단계: WSLg 환경에서 Emacs 실행하기

Windows 11의 WSL은 WSLg 기능을 지원하므로 별도의 X 서버 설정 없이도 리눅스 GUI 프로그램을 윈도우 화면에 바로 띄울 수 있습니다.

1.    터미널에 다음 명령어를 입력하여 GUI 환경으로 Emacs를 실행합니다.

Bash

emacs &

2.    백그라운드로 윈도우 바탕화면에 Emacs 창이 정상적으로 뜨는지 확인합니다. 만약 터미널 내부에서 가볍게 텍스트 모드로 실행하고 싶다면 다음 명령어를 사용하세요.

Bash

emacs -nw

5 단계: 아이콘 깨짐 방지 폰트 설치 (중요)

WSL 내부 우분투 시스템에도 폰트를 인식시켜 주어야 아이콘이 깨지지 않고 올바르게 렌더링됩니다.

1.    실행된 Emacs 창에서 M-x (보통 Alt + x)를 누르고 nerd-icons-install-fonts를 입력 후 Enter를 누릅니다.

2.    다운로드 경로 질문이 나오면 기본값 그대로 Enter를 눌러 진행합니다.

3.    폰트 파일들이 우분투의 ~/.local/share/fonts/ 경로에 저장됩니다.

4.    우분투 시스템이 폰트 캐시를 갱신하도록 터미널에서 다음 명령어를 실행합니다.

Bash

fc-cache -f -v

5.    Emacs를 종료한 뒤 다시 실행하면 화려한 아이콘들이 깨짐 없이 완벽하게 표시됩니다.

 

[참고]

doom emacs를 윈도우11에서 설치하는 방법 

윈도우 11 환경에서 Doom Emacs를 설치하는 과정은 리눅스나 macOS에 비해 조금 복잡하지만, 차근차근 따라 하시면 무리 없이 완료할 수 있습니다.

윈도우에서 가장 추천하는 패키지 매니저인 Scoop을 이용한 설치 방법을 단계별로 안내해 드립니다.

1 단계: 필수 도구 설치하기 (Git, Ripgrep, fd)

Doom Emacs는 속도와 검색 최적화를 위해 내부적으로 git, ripgrep, fd 등의 외부 CLI 도구를 적극적으로 활용합니다.

1.    PowerShell을 관리자 권한으로 실행합니다.

2.    Scoop이 설치되어 있지 않다면 아래 명령어를 차례로 입력하여 Scoop을 설치합니다.

PowerShell

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

Invoke-RestMethod -Uri https://get.scoop.sh | Invoke-Expression

3.    Scoop을 통해 필수 종속성 패키지들을 설치합니다. (Emacs GUI를 설치하기 위해 extras 버킷도 추가해야 합니다)

PowerShell

scoop bucket add extras

scoop install git ripgrep fd emacs

2 단계: Windows 환경 변수 설정

윈도우에서는 Emacs가 기본적으로 AppData\Roaming 폴더를 홈 디렉터리로 인식하기 때문에, 정상적인 리눅스 스타일 경로(~ 또는 C:\Users\사용자이름)를 찾아갈 수 있도록 HOME 환경 변수를 반드시 지정해 주어야 합니다.

1.    시작 메뉴에서 "시스템 환경 변수 편집"을 검색하여 실행합니다.

2.    우측 하단의 [환경 변수...] 버튼을 누릅니다.

3.    사용자 변수 섹션에서 [새로 만들기...]를 클릭합니다.

o   변수 이름: HOME

o   변수 값: C:\Users\본인의윈도우사용자이름 (예: C:\Users\John)

4.    사용자 변수 중 Path를 선택하고 [편집...]을 누른 뒤, [새로 만들기]를 클릭해 아래 경로를 추가합니다.

o   C:\Users\본인의윈도우사용자이름\.config\emacs\bin (이 경로는 이후 Doom Emacs 실행 명령어인 doom을 아무 터미널에서나 바로 쓰기 위함입니다.)

5.    확인을 눌러 모든 창을 닫아줍니다.

3 단계: Doom Emacs 소스코드 복사 (Clone)

과거에는 .emacs.d 경로를 썼으나, 현재 Doom Emacs는 XDG 규격을 따라 ~/.config/emacs 경로 설치를 기본 권장합니다.

1.    새로운 PowerShell 창을 엽니다. (환경 변수가 새로 고침되어 적용되도록 새로 열어야 합니다.)

2.    아래 명령어를 실행하여 Doom Emacs 저장소를 내려받습니다.

PowerShell

git clone --depth 1 https://github.com/doomemacs/doomemacs ~/.config/emacs

4 단계: Doom Emacs 설치 실행

1.    다운로드가 완료되면 다음 명령어를 입력하여 설치 스크립트를 작동시킵니다.

PowerShell

~/.config/emacs/bin/doom install

2.    설치 프로세스가 진행되는 도중 터미널에 몇 가지 질문이 나옵니다.

o   "Generate an envvar file?" (환경 변수 파일 생성 여부) 👉 y 입력

o   "Install all-the-icons fonts?" (아이콘 폰트 다운로드 여부) 👉 y 입력 (글리프 아이콘이 깨지지 않게 해줍니다)

설치 과정에 다소 시간이 소요될 수 있습니다. 모든 과정이 끝나면 이제 터미널에 emacs를 입력하거나, 윈도우 시작 메뉴에서 Emacs 앱을 실행해 보세요. 아름다운 Doom Emacs 대시보드를 보실 수 있습니다.

5 단계: 아이콘 폰트 수동 설치 (필수 마무리)

설치 과정에서 폰트를 내려받았더라도 윈도우 시스템에 직접 등록해 주어야 아이콘들이 깨지지 않습니다.

1.    Emacs가 켜지면 단축키 M-x (일반적으로 Alt + x)를 누릅니다.

2.    하단 미니버퍼에 nerd-icons-install-fonts를 입력하고 Enter를 누릅니다.

3.    폰트 파일이 윈도우 다운로드 폴더 등에 저장됩니다. 해당 폴더로 이동해 내려받은 폰트 파일들(.ttf 등)을 더블클릭하여 [설치]해 줍니다.

4.    Emacs를 재시작하면 모든 아이콘이 정상적으로 표시됩니다.