Mise Windows 装 Node.js 权限报错，一次修好

【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/mise

Windows 上 Mise 安装 Node.js 报权限错误，多半是数据目录落在受保护路径，挪到普通盘或临时提权都能装通。适用于 Win10/11 与近期版本。

🔍 先对号入座

动手前先看报错长得像不像下面几种，命中任意一条再往下走：

• 执行mise use -g node@20时卡在写盘阶段，报拒绝访问：

permission denied: C:\Users\you\AppData\Local\mise\installs\node\20.x.x（中文系统显示为「拒绝访问。」）

• 安装过程没报错，可新开终端执行node -v提示'node' 不是内部或外部命令
• 运行mise doctor，输出里 data dir 一行被标黄

为什么会卡在这

Mise 把每个装好的工具都落在数据目录里，Windows 上默认是%LOCALAPPDATA%\mise。如果你的终端开过 UAC 管理员、或机器受组策略管控，写这个路径会被系统直接拒绝：下载能下完，落盘就卡死。坑在这——不是 Node.js 难装，是落脚的目录不对。

图是 Linux 机器上的通用示意：mise.toml 里锁住 node 版本，终端里的 node 命令走 mise 的 shim 解析，Windows 机制相同。

🛠 按这个顺序试

把数据目录挪到普通盘（主推）

1. 先跑mise doctor，找到 data dir 一行，确认默认位置确实是%LOCALAPPDATA%\mise。
2. 用持久化的用户级变量把数据目录指到非系统保护盘，路径按自己的改：

setx MISE_DATA_DIR "D:\dev\mise"

命令行回显「成功。」即生效，但它只影响之后新开的进程，别在当前窗口里干等。 3. 新开一个 PowerShell，确认变量带进来了：

$env:MISE_DATA_DIR

预期输出D:\dev\mise。 4. 重装一次：

mise use -g node@20

预期现象：下载完成后不再报拒绝访问，mise ls能列出 node 版本。挪完之后，工具安装、下载缓存、shim 全落在 D 盘，不再碰受保护路径。

用管理员 PowerShell 跑一次（备选）

右键 PowerShell 选「以管理员身份运行」，再执行mise use -g node@20。适合只装这一个工具的临时场景；没放主推，是因为每装一个新工具都要再提权一次，治标不治本。

给默认数据目录放开权限（备选）

文件管理器打开%LOCALAPPDATA%\mise，属性 → 安全，给当前用户勾完全控制。适合目录挪不走（如受管控机器）的情况，改完立即生效，但受保护路径的根源还在，所以排备选。

装完怎么确认没白装

就两条命令，都过才算装好：

node -v

预期输出v20.x.x，主版本号要和你要的一致。

npm -v

预期输出10.x.x，说明 node 自带的 npm 读写也正常。

还是不行？

先别急，大多是细节问题，对照查：

还解决不了的话，先到 docs/troubleshooting.md 对一遍常见问题，再带上完整的mise doctor输出求助。

mise 各目录的默认位置和覆盖规则，见 docs/directories.md。

【免费下载链接】misedev tools, env vars, task runner项目地址: https://gitcode.com/GitHub_Trending/mi/mise