uga.dev - A Front-end Engineer's shed

現在のテーマは「ライトモード」です。

../１つ上のページへ戻る

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]。

~/.config/mise/config.toml
  [settings]
- idiomatic_version_file_disable_tools = ["nodejs"]
- idiomatic_version_file = true
+ idiomatic_version_file_enable_tools = ["node"]

`mise doctor`で確認

zsh
mise doctor

問題が発生していないかを確認できるコマンドが用意されているので、読み込まれている設定ファイルと現状の設定内容を確認しておくと安心です。

zsh
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 をインストールした際には、以下のような警告が出ました。

zsh
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]。

zsh
touch ~/.config/mise/config.toml
mise trust ~/.config/mise/config.toml

脚注

𝕏拍手する