# mise.toml 配置参考

mise 从 mise.toml 读取的所有配置项均根据 https://mise.jdx.dev/schema/mise.json 生成，
每个顶层配置段各有一个文件。尖括号中的名称（如 `tasks.<name>`）表示由你自选的配置项名称，
而 `<list>[].<key>` 表示列表中每个表格的对应配置项。 也可在网页中筛选和浏览：https://mise.jdx.dev/configuration/reference.html

## 工具

- [`tools`](https://mise.jdx.dev/configuration/reference/tools.md): dev tools to use （285 个配置项）。指南：[开发工具](https://mise.jdx.dev/dev-tools/)
- [`tool_alias`](https://mise.jdx.dev/configuration/reference/tool_alias.md): Tool version aliases （5 个配置项）。指南：[工具别名](https://mise.jdx.dev/dev-tools/aliases.html)
- [`tool_config`](https://mise.jdx.dev/configuration/reference/tool_config.md): policy for tools declared by this config root （1 个配置项）。指南：[工具策略](https://mise.jdx.dev/configuration.html#tool-config)
- [`plugins`](https://mise.jdx.dev/configuration/reference/plugins.md): plugins to use （1 个配置项）。指南：[插件](https://mise.jdx.dev/configuration.html#plugins)
- [`wrappers`](https://mise.jdx.dev/configuration/reference/wrappers.md): commands that intercept a binary name before delegating to the active toolset （5 个配置项）。指南：[命令包装器](https://mise.jdx.dev/dev-tools/shims.html#command-wrappers)

## 环境

- [`env`](https://mise.jdx.dev/configuration/reference/env.md): environment variables to set （33 个配置项）。指南：[环境变量](https://mise.jdx.dev/environments/)
- [`vars`](https://mise.jdx.dev/configuration/reference/vars.md): variables to set for use in config templates （15 个配置项）。指南：[配置变量](https://mise.jdx.dev/configuration/vars.html)
- [`redactions`](https://mise.jdx.dev/configuration/reference/redactions.md): env or vars keys to redact from logs。指南：[敏感值脱敏](https://mise.jdx.dev/environments/secrets/#redaction)
- [`secrets`](https://mise.jdx.dev/configuration/reference/secrets.md): Sources for mise secrets: values resolved only when mise starts a task or `mise x` command that was granted them. Project config only. （2 个配置项）。指南：[fnox](https://mise.jdx.dev/environments/secrets/fnox.html)

## 任务

- [`tasks`](https://mise.jdx.dev/configuration/reference/tasks.md): task runner tasks （96 个配置项）。指南：[任务](https://mise.jdx.dev/tasks/)
- [`task_config`](https://mise.jdx.dev/configuration/reference/task_config.md): configuration for task execution and management （18 个配置项）。指南：[任务配置](https://mise.jdx.dev/tasks/task-configuration.html#task-config-options)
- [`task_templates`](https://mise.jdx.dev/configuration/reference/task_templates.md): task templates that can be extended by tasks via extends （40 个配置项）。指南：[任务模板](https://mise.jdx.dev/tasks/templates.html)
- [`monorepo`](https://mise.jdx.dev/configuration/reference/monorepo.md): configuration for monorepo task discovery （15 个配置项）。指南：[Monorepo 任务](https://mise.jdx.dev/tasks/monorepo.html)
- [`monorepo_root`](https://mise.jdx.dev/configuration/reference/monorepo_root.md): marks this config as a monorepo root for task path syntax。指南：[Monorepo 任务](https://mise.jdx.dev/tasks/monorepo.html)

## 钩子与 Shell

- [`hooks`](https://mise.jdx.dev/configuration/reference/hooks.md): hooks to run on events like cd, enter, leave （17 个配置项）。指南：[钩子](https://mise.jdx.dev/hooks.html)
- [`watch_files`](https://mise.jdx.dev/configuration/reference/watch_files.md): files to watch for changes and run scripts when modified （4 个配置项）。指南：[钩子](https://mise.jdx.dev/hooks.html)
- [`shell_alias`](https://mise.jdx.dev/configuration/reference/shell_alias.md): shell aliases （1 个配置项）。指南：[Shell 别名](https://mise.jdx.dev/shell-aliases.html)

## 配置文件

- [`settings`](https://mise.jdx.dev/configuration/reference/settings.md): mise settings。指南：[设置](https://mise.jdx.dev/configuration/settings.html)
- [`include`](https://mise.jdx.dev/configuration/reference/include.md): config files merged into this one, ranking just below it: a local path (relative to this file), git::<url>//<path>.toml?ref=<ref> or oci::<registry>/<repo>[:tag|@sha256:<digest>] (the artifact holds a mise.toml). Paranoid mode requires a commit sha or digest for remote includes and rejects local ones; otherwise a branch or tag is refreshed after fetch_remote_versions_cache。指南：[include](https://mise.jdx.dev/configuration.html#include)
- [`min_version`](https://mise.jdx.dev/configuration/reference/min_version.md): minimum version of mise required to use this config （2 个配置项）。指南：[最低 mise 版本](https://mise.jdx.dev/configuration.html#minimum-mise-version)
- [`doctor`](https://mise.jdx.dev/configuration/reference/doctor.md): Project diagnostic checks, run explicitly with mise doctor project. （9 个配置项）。指南：[项目诊断](https://mise.jdx.dev/configuration/project-diagnostics.html)
- [`_`](https://mise.jdx.dev/configuration/reference/_.md): free-form data for your own use; mise never reads it。指南：[自由格式数据](https://mise.jdx.dev/configuration.html#free-form-data)

## 项目服务

- [`deps`](https://mise.jdx.dev/configuration/reference/deps.md): configure deps providers （27 个配置项）。指南：[项目依赖](https://mise.jdx.dev/dev-tools/deps.html)
- [`oci`](https://mise.jdx.dev/configuration/reference/oci.md): configuration for `mise oci build` （16 个配置项）。指南：[OCI 镜像](https://mise.jdx.dev/dev-tools/mise-oci.html)
- [`daemons`](https://mise.jdx.dev/configuration/reference/daemons.md): Experimental project daemons: custom pitchfork commands or managed presets. （23 个配置项）。指南：[守护进程](https://mise.jdx.dev/daemons.html)
- [`daemon_groups`](https://mise.jdx.dev/configuration/reference/daemon_groups.md): Experimental named groups of project daemons. Members are daemon names or other group names declared in the same project. （2 个配置项）。指南：[守护进程组](https://mise.jdx.dev/daemons.html#groups)
- [`daemons_settings`](https://mise.jdx.dev/configuration/reference/daemons_settings.md): Experimental project-wide daemon options. （2 个配置项）。指南：[端口、URL 与工作树](https://mise.jdx.dev/daemons/worktrees.html#namespaces)
- [`daemon_providers`](https://mise.jdx.dev/configuration/reference/daemon_providers.md): Experimental shared servers owned by the user. Only allowed in global configuration. （12 个配置项）。指南：[在项目间共享守护进程](https://mise.jdx.dev/daemons/sharing.html)

## 机器初始化

- [`bootstrap`](https://mise.jdx.dev/configuration/reference/bootstrap.md): machine-global bootstrapping (system packages, repos, macOS defaults, launchd agents, login shell) （364 个配置项）。指南：[初始化](https://mise.jdx.dev/bootstrap.html)
- [`dotfiles`](https://mise.jdx.dev/configuration/reference/dotfiles.md): dotfiles applied with `mise dotfiles apply` or `mise bootstrap`, keyed by target path or a logical name when every variant overrides the target; an omitted source for the latter resolves the relative key under dotfiles.root （27 个配置项）。指南：[Dotfiles](https://mise.jdx.dev/dotfiles.html)
- [`dotfile_groups`](https://mise.jdx.dev/configuration/reference/dotfile_groups.md): named directory trees of dotfiles, applied with `mise dotfiles apply` or `mise bootstrap` while [bootstrap] dotfile_groups selects them (or is unset) （10 个配置项）。指南：[Dotfile 组](https://mise.jdx.dev/dotfiles/groups.html)
- [`history`](https://mise.jdx.dev/configuration/reference/history.md): dotfiles history: what is never captured, reload commands, and the setup repository (https://mise.jdx.dev/history.html) （10 个配置项）。指南：[Dotfiles 历史记录](https://mise.jdx.dev/dotfiles/history.html)

## 已弃用

- [`alias`](https://mise.jdx.dev/configuration/reference/alias.md): custom shorthands；与 `tool_alias` 使用相同配置项。指南：[工具别名](https://mise.jdx.dev/dev-tools/aliases.html)
- [`dotenv`](https://mise.jdx.dev/configuration/reference/dotenv.md): dotenv file(s) to load. Deprecated; use env._.file instead. This will be removed in mise 2027.4.0.。指南：[环境变量](https://mise.jdx.dev/environments/)
- [`env_file`](https://mise.jdx.dev/configuration/reference/env_file.md): dotenv file(s) to load. Deprecated; use env._.file instead. This will be removed in mise 2027.4.0.。指南：[环境变量](https://mise.jdx.dev/environments/)
- [`env_path`](https://mise.jdx.dev/configuration/reference/env_path.md): PATH entries to add. Deprecated; use env._.path instead. This will be removed in mise 2027.4.0.。指南：[环境变量](https://mise.jdx.dev/environments/)
- [`experimental_monorepo_root`](https://mise.jdx.dev/configuration/reference/experimental_monorepo_root.md): deprecated alias of monorepo_root。指南：[Monorepo 任务](https://mise.jdx.dev/tasks/monorepo.html)