프로젝트마다 다른 개발 도구와 환경 변수를 한 파일로 정리해 주는 방법
새 프로젝트를 열 때마다 필요한 언어 버전을 설치하고, 환경 변수를 설정하고, 빌드 명령을 찾는 과정이 반복되지 않습니다. mise는 프로젝트 폴더에 있는 mise.toml 파일 하나를 보고 필요한 도구를 설치하고 환경을 맞춰 줍니다. 쉘, 에디터, CI 환경 어디서든 같은 설정을 유지할 수 있게 합니다.
mise.toml 하나로 관리하는 세 가지 요소
mise는 개발 도구, 환경 변수, 태스크를 하나의 설정 파일에서 다룹니다. Node.js나 Python 같은 도구의 버전을 지정하면 필요한 버전이 자동으로 설치됩니다. .env 파일이나 PATH 항목 같은 환경 설정도 자동으로 로드됩니다. mise.toml에 정의한 태스크는 의존성 관계와 병렬 실행을 지원하며, 해당 프로젝트의 도구와 환경이 이미 준비된 상태에서 실행됩니다. 필요한 부분만 선택적으로 사용할 수 있어 기존 .tool-versions 파일과 함께 쓰기도 합니다.
쉘 설정을 건드리지 않고 도구 실행
mise exec 명령을 사용하면 현재 쉘 설정을 변경하지 않고 특정 버전의 도구를 실행할 수 있습니다. 예를 들어 mise exec node@24 -- node --version을 실행하면 Node.js 24가 설치되어 있지 않으면 다운로드한 뒤 해당 버전으로 명령을 실행합니다. 이 방식은 전역 환경에 영향을 주지 않으므로 임시로 다른 버전을 테스트할 때 유용합니다. 쉘 활성화 기능을 켜면 디렉토리를 이동할 때마다 PATH와 환경 변수가 자동으로 갱신되어 node를 직접 호출할 수도 있습니다.
새로운 머신 설정 자동화
프로젝트 밖의 시스템 설정도 ~/.config/mise/config.toml로 관리할 수 있습니다. 이를 통해 새로운 컴퓨터를 설정할 때 수동으로 하나씩 설치하던 과정을 줄일 수 있습니다.
적용 전 확인해야 할 사항
mise는 Rust로 작성된 CLI 도구로, macOS, Linux, Windows에서 사용할 수 있습니다. 프로젝트 팀원들이 동일한 환경을 사용하려면 mise.toml을 커밋하고, 정확한 버전 고정에는 mise lock을 사용하는 것이 좋습니다. 기존 버전 관리 파일과 호환되지만, 쉘별 활성화 명령이 다르므로 사용 중인 쉘에 맞는 설정을 적용해야 합니다.
