mise 런타임 버전 관리

mise를 사용한 Node.js, pnpm 등 런타임 버전 관리 가이드.

목적과 범위

런타임 버전 선택, shims 경로, SSH 비대화형 셸 이슈를 안정적으로 운영하는 절차를 다룬다. macOS에서는 Homebrew로 mise를 설치하고, NixOS에서는 pkgs.mise를 사용한다.

항목	macOS	NixOS
mise 설치	Homebrew	`libraries/packages.nix` (nixosOnly)
소스 빌드	기본값 사용	`MISE_ALL_COMPILE=0` 환경변수로 비활성화
Node 빌드	기본값 사용	`MISE_NODE_COMPILE=0` 환경변수로 비활성화
환경변수 위치	-	`modules/shared/programs/shell/nixos.nix`

bash

# 현재 버전 확인
mise current

# 전역 버전 설정
mise use -g node@lts

# 프로젝트 버전 설치
mise install node@20.18

# 프로젝트 설정 신뢰
mise trust

파일	용도
`modules/shared/programs/shell/default.nix`	zsh mise 활성화 (shims + activate)
`modules/shared/programs/shell/nixos.nix`	NixOS 환경변수 (`MISE_ALL_COMPILE=0`, `MISE_NODE_COMPILE=0`)
`libraries/packages.nix`	`pkgs.mise` 패키지 설치 (nixosOnly)

mise는 두 계층으로 활성화된다:

계층	파일	명령어	용도
`.zshenv`	`shell/default.nix` envExtra	`mise activate zsh --shims`	비대화형 SSH 세션 (PATH에 shim만 추가)
`.zshrc`	`shell/default.nix` initContent	`mise activate zsh`	대화형 셸 (cd 시 자동 버전 전환 등 전체 훅)

MISE_SHELL 환경변수로 중복 활성화를 방지한다.

mise current로 현재 선택된 런타임을 확인한다.
전역 버전이 필요하면 mise use -g node@lts로 고정한다.
프로젝트별 버전은 mise.toml 또는 .nvmrc 기준으로 mise install을 실행한다.
.nvmrc 인식이 필요하면 mise settings add idiomatic_version_file_enable_tools node를 실행한다.
비대화형 셸 문제는 ~/.zshenv의 shims 경로와 mise activate 적용 여부를 점검한다.

SSH 비대화형 세션에서 pnpm not found: .zshenv에 mise shims 누락 → 셸 활성화 구조 참조
.nvmrc 인식 안 됨: mise 2025.10.0부터 기본 비활성화 → idiomatic_version_file_enable_tools 설정 필요
NixOS에서 node 빌드 실패: MISE_NODE_COMPILE=0 필요 (현재 nixos.nix에서 영구 설정됨)
mise.local.toml 미신뢰: mise trust 실행 필요 (최초 1회)