[Vagrant] "incompatible character encodings: UTF-8 and CP949" 오류 해결

Windows에서 vagrant up을 실행하다가 인코딩 오류가 났습니다. 원인은 사용자 계정 이름이 한글이라 경로에 한글이 들어간 것이었고, Vagrant와 VirtualBox 기본 머신 폴더를 한글이 없는 경로로 옮겨 해결했습니다.

1. 증상

Vagrant를 설치하고 vagrant up으로 가상 머신을 띄우려는데 아래 오류가 났습니다.

Encoding::CompatibilityError: incompatible character encodings: UTF-8 and CP-949

2. 원인

사용자 계정 이름이 한글이라 경로에 한글이 포함되어 있었고, 이 때문에 Vagrant가 기본 설정 파일을 제대로 읽지 못했습니다.

3. 해결 방법

방법	내용
1. 영문 계정 사용	영문 이름으로 된 사용자 계정을 새로 만들어 Vagrant 사용
2. 설치 경로 변경	Vagrant를 한글이 없는 경로에 설치하고, VirtualBox 기본 머신 폴더도 영문 경로로 변경

 

VirtualBox를 쓴다면 파일 > 환경설정 > 일반에서 기본 머신 폴더를 바꿀 수 있습니다.

4. 결과

저는 2번 방법을 썼습니다. Vagrant를 다른 디스크에 설치해 경로에 한글이 없게 하고, VirtualBox 기본 머신 폴더도 그 디스크로 옮기니 오류가 사라졌습니다.

5. 정리

• Windows 사용자 이름이 한글이면 Vagrant가 경로를 제대로 처리하지 못할 수 있습니다.
• Vagrant 설치 경로와 VirtualBox 기본 머신 폴더를 모두 영문 경로로 두면 해결됩니다.