asdf에서 mise로 마이그레이션하기, 번거로움 없이
발행: (2025년 12월 22일 오후 05:05 GMT+9)
3 min read
원문: Dev.to
Source: Dev.to
1. asdf 플러그인 제거 및 asdf 삭제
# remove plugins
asdf plugin list | xargs -n 1 asdf plugin remove
# uninstall asdf
brew uninstall asdf --force
brew autoremove
.zshrc 정리
# ASDF configuration
. "$BREW_PREFIX/opt/asdf/libexec/asdf.sh"
남은 파일 제거
rm -rf ~/.asdf
rm -rf ~/.tool-versions
asdf가 삭제되었는지 확인
brew list asdf
# Expected output:
# Error: No such keg: /opt/homebrew/Cellar/asdf
2. mise 설치
- 프로젝트 페이지:
- 시작하기:
brew install mise
설치 확인
mise --version
_ __
____ ___ (_)_______ ___ ____ ____ / /___ _________
/ __ `__ \/ / ___/ _ \______/ _ \/ __ \______/ __ \/ / __ `/ ___/ _ \
/ / / / / / (__ ) __/_____/ __/ / / /_____/ /_/ / / /_/ / /__/ __/
/_/ /_/ /_/_/____/\___/ \___/_/ /_/ / .___/_/\__,_/\___/\___/
/_/ by @jdx
2025.12.12 macos-arm64 (2025-12-18)
셸 설정에 활성화 라인 추가
(필요에 따라 zsh를 bash 또는 fish로 교체하세요)
eval "$(mise activate zsh)"
3. mise 플러그인 설치
이 예시에서는 nodejs, pnpm, bun, yarn, python을 설치합니다.
사용 가능한 플러그인 목록
mise plugins ls-remote
핵심 플러그인
mise plugins ls --core
# bun, deno, elixir, erlang, go, java, node, python, ruby, rust, swift, zig
사용 가능한 버전 확인
mise ls-remote node
mise ls-remote pnpm
mise ls-remote bun
mise ls-remote yarn
mise ls-remote python
특정 버전 설치
mise install node@22.21.1
mise install yarn@1.22.22
mise install pnpm@10.22.0
mise install bun@1.3.5
mise install python@3.12.12
또는 mise.toml 파일 사용
프로젝트 디렉터리에 mise.toml을 생성합니다:
[tools]
node = "22.21.1"
python = "3.12.12"
yarn = "1.22.22"
pnpm = "10.22.0"
신뢰 오류가 발생하면 다음을 실행하세요:
mise trust
mise install
설치된 버전 확인
yarn -v
# 1.22.22
node -v
# v22.21.1
python --version
# Python 3.12.12
zsh: command not found: node 오류가 발생하면 .zshrc에 활성화 라인이 포함되어 있는지 확인하세요:
eval "$(mise activate zsh)"
4. asdf → mise 명령 매핑
| asdf (modern) | mise 대응 | 비고 |
|---|---|---|
.tool-versions | mise.toml | 프로젝트 로컬 도구 정의 |
asdf set | Edit mise.toml | asdf local/global을 대체 |
asdf set -u | ~/.config/mise/config.toml | 사용자/전역 설정 |
asdf install | mise install | 정의된 모든 도구 설치 |
asdf exec | mise exec -- | 고정된 도구와 함께 실행 |
asdf current | mise current | 활성 버전 표시 |
asdf plugin add | (implicit) | mise가 플러그인을 자동 관리 |
asdf plugin list | mise ls | 설치된 도구 목록 |
| shims | Shell activation (mise activate) | PATH 기반 |
.asdf/installs | ~/.local/share/mise/installs | 도구 설치 |
.asdf/shims | ~/.local/share/mise/shims | 실행 가능한 shim |