miseの警告`deprecated [idiomatic_version_file_enable_tools]:`について
-
- #バージョン管理ツール
- #mise
- #Node.js
mise の バージョン「2025.10.0」以降から、.nvmrc
や.node-version
といった慣用的なバージョンファイルの自動読み込みが無効になる[1]ため、明示的にどうしたいかを示す必要があります。
mise settings add idiomatic_version_file_enable_tools node
mise settings add idiomatic_version_file_enable_tools "[]"
また、これまでに非推奨になっている設定値が使われている場合はmise settings unset <KEY>
をするか、設定ファイルを直接編集しておくとよさそうです[2]。
[settings]
- idiomatic_version_file_disable_tools = ["nodejs"]
- idiomatic_version_file = true
+ idiomatic_version_file_enable_tools = ["node"]
mise doctor
で確認
mise doctor
問題が発生していないかを確認できるコマンドが用意されているので、読み込まれている設定ファイルと現状の設定内容を確認しておくと安心です。
config_files:
~/.tool-versions
~/.config/mise/config.toml
~/works/hiroya-uga.github.io/.tool-versions
...
settings:
idiomatic_version_file_enable_tools ["node"] ~/.config/mise/config.toml
余談
実際に新しいPCに mise をインストールした際には、以下のような警告が出ました。
mise WARN deprecated [idiomatic_version_file_enable_tools]:
Idiomatic version files like ~/works/hoge/.nvmrc are currently enabled by default. However, this will change in mise 2025.10.0 to instead default to disabled.
You can remove this warning by explicitly enabling idiomatic version files for node with:
mise settings add idiomatic_version_file_enable_tools node
You can disable idiomatic version files with:
mise settings add idiomatic_version_file_enable_tools "[]"
See https://github.com/jdx/mise/discussions/4345 for more information.
mise 2025.8.13 by @jdx – ✓ use mise ~/works/hoge/.tool-versions tools: node@xx.xx.x
設定ファイルが存在していないときは、作った後で mise に信頼できる設定ファイルだということを伝える必要があります[3]。
touch ~/.config/mise/config.toml
mise trust ~/.config/mise/config.toml
脚注
- [^1]:idiomatic versions default disabled #4345
- [^2]:
mise WARN deprecated [idiomatic_version_file_disable_tools]: is deprecated, use idiomatic_version_file_enable_tools instead
という警告が出る。 - [^3]:セキュリティの観点から、ユーザが明示的に信頼した設定ファイルしか読み込まない仕組みになっている。参考:https://mise.jdx.dev/cli/trust.html