症状： 执行 npm 全局安装时出现 EACCES，提示没有权限写入目录。
最快处理： 先核对 Node.js、npm 和全局安装目录的路径；再优先考虑 Node 版本管理器，不要用 sudo 强行安装，也不要先改系统目录权限。
Node.js 官方发布页将 Node.js 24 列为 LTS；具体版本和状态以官方发布状态页及 Node.js 24 下载归档为准。面对权限报错，关键不是换一个命令反复试，而是先查清当前终端实际调用哪套 Node.js 和 npm，再判断安装目标是否可写。
适合刚装好 Node.js 24、第一次运行全局安装命令就遇到报错的学生。
如果你使用学校 Mac 或远程 Mac、没有管理员权限，也可以按本文步骤判断何时应该停下。
如果项目能运行，只是偶尔需要命令行工具，你还可以比较临时运行和全局安装。
SECTION 01先确认报错来自全局安装还是项目依赖
npm 的本地安装默认把包放进当前项目的 node_modules；加上 -g 才是全局安装。可以把全局工具理解成“所有课程都能调用的工具”，项目依赖则是“只放在当前课程项目里的工具”。两者的安装位置和权限问题不同。(npm 全局安装说明)
先回到终端查看你刚才实际输入的命令，并确认终端所在位置：
| 你运行的命令 | 包通常安装到哪里 | 下一步先查什么 |
|---|---|---|
npm install -g 工具名 |
npm 的全局安装目录 | 全局目录是否可写，以及 Node.js、npm 路径是否一致 |
npm install 或 npm install 包名 |
当前项目的 node_modules |
当前目录是否为课程项目、项目目录是否可写 |
| 课程给出的脚本或编辑器任务 | 取决于脚本和运行环境 | 脚本实际调用的 npm、node 和工作目录 |
如果失败命令没有 -g，先不要照搬“修复全局权限”的办法。项目依赖安装失败还可能与项目目录权限、网络或依赖本身有关；错误中的路径和执行命令比错误标题更能说明问题。
SECTION 02EACCES 出现时，按顺序核对路径
npm 全局安装目录可以由 prefix 配置影响；在 Unix 系统上，全局包和命令入口会分别落在这个安装前缀下的目录中。若该位置属于系统级安装，普通账户可能没有写入权限。npm 官方也将目录权限列为全局安装遇到 EACCES 时应处理的问题。(npm 全局目录说明)
在同一个终端窗口逐条运行以下检查命令。它们用于查看现状，不会删除或修改安装文件：
node -v
npm -v
command -v node
command -v npm
npm config get prefix
npm root -g
command -v 会显示当前 shell 找到的命令位置；npm config get prefix 查看全局安装前缀，npm root -g 查看全局包目录。npm 文档说明，全局安装会使用 prefix，并把可执行命令放在对应的 bin 目录。(npm 配置说明)
| 检查结果 | 可能情况 | 安全动作 |
|---|---|---|
node 与 npm 位于明显不同的安装路径 |
终端可能混用了旧安装和新安装 | 暂停修改权限，先确认课程指定版本及安装方式 |
| prefix 指向你无权写入的系统位置 | 全局安装目标目录不可写 | 优先评估版本管理器；否则再评估用户目录 |
| 终端能运行命令，但编辑器终端找不到 | 两个终端启动时读取的环境配置可能不同 | 分别在系统终端和编辑器终端检查命令路径 |
PATH 可以理解成终端的“寻路清单”：它决定你输入命令时，终端按什么顺序寻找程序。编辑器集成终端可能使用不同的启动环境；编辑器终端配置文档说明，macOS 上登录 shell 和环境初始化会影响终端的 PATH 顺序。
⚠️ 如果检查结果仍显示不出 Node.js 与 npm 分别来自哪里，先停在这里。不要删除旧目录、对系统位置执行递归权限修改，也不要用
sudo npm install -g来绕过错误。
SECTION 03选择不会扰动课程环境的修复路线
npm 官方对全局安装的 EACCES 优先建议是使用 Node 版本管理器；另一条路线是把 npm 的全局目录改到用户目录。前者更适合需要管理不同课程版本的情况，后者适合你能维护自己的 shell 配置、又不方便更换安装方式的情况。两种路线都应先与课程要求核对。(npm 官方 EACCES 排查指南)
路线 A：使用 Node 版本管理器
Node 版本管理器是管理多套课程工具的办法：你可以按项目切换 Node.js 版本，而不必让所有课程共用同一套全局安装。npm 官方建议通过版本管理器安装 Node.js 和 npm，也将它列为处理全局权限问题的优先方向。
适用：课程允许你调整个人开发环境，或你需要为不同项目维护不同 Node.js 版本。操作前先记录课程指定版本和现有检查结果，再按所选工具的官方说明完成安装；不要在已经有安装残留时，凭网络上的一条命令盲目重装。
停止条件：学校设备禁止自行安装管理工具、课程必须使用管理员提供的环境，或新旧安装路径尚未分清。此时联系管理员或课程教师，不要自行清理系统目录。
路线 B：把全局目录改到用户目录
如果暂时不更换安装方式，npm 官方说明可以把全局目录指向用户目录，并在 shell 配置中加入对应的 bin 路径。官方示例包含 npm config set prefix ~/.local，以及为 zsh 检查 ~/.zprofile 的步骤；这些是文档中的示例，不代表每台 Mac 的 shell 配置都相同。
先确认自己使用的 shell，再对照 npm 的 EACCES 指南核对配置。如果你不熟悉 .profile、.zprofile 或 PATH，先备份准备修改的文件，并只按当前 shell 的官方步骤操作。npm 的配置可能来自命令行、环境变量和不同层级的 .npmrc，所以检查用户配置时也要留意设置来源。
| 选择 | 优点 | 代价与停止条件 |
|---|---|---|
| 版本管理器 | 适合课程间切换版本，也符合 npm 优先推荐方向 | 需要先核对课程版本；设备政策不允许安装时应停止 |
| 用户目录 | 不必把全局包写入系统级目录 | 需要正确调整 PATH；shell 配置不清楚或受学校管理时先求助 |
| 临时运行工具 | 偶尔使用时可避免长期维护全局安装 | 需核对工具支持的运行方式；课程明确要求全局命令时不能直接替代 |
如果你只是偶尔调用某个命令，可以先查看课程是否接受 npx 等临时运行方式；若课程脚本依赖全局命令，则应按课程要求验证，不能因为临时运行成功就假定环境已经完全相同。
SECTION 04按决策条件选路线，再分步验证
- 若课程指定 Node.js 版本，且你有权维护个人环境，则优先选择版本管理器；若学校禁止安装，回到管理员提供的环境，不要绕过限制。
- 若当前安装来源清楚、只是全局目录不可写，而且你能安全维护 shell 配置，则评估用户目录方案；否则停下并请管理员协助。
- 若只偶尔需要某个工具，且课程允许临时运行，则先检查
npx等方式；若课程要求全局命令，按课程要求配置并验证。
按下面的顺序执行，每一步都保留检查结果，避免一次改动多个变量后找不到原因：
- 记录失败命令。 区分是否包含
-g，保存完整错误文本及报错路径；不要只记住 EACCES 这个词。 - 核对课程要求。 查看课程说明中的 Node.js 版本和工具调用方式；如果要求固定版本，先不要升级或更换环境。
- 检查当前路径。 运行前述检查命令，在同一个终端记录 Node.js、npm 和全局 prefix 的结果；必要时在编辑器终端再检查一遍。
- 选定一种修复方式。 优先遵照 npm 官方建议使用版本管理器；若不适合，再核对用户目录方案。不要同时更换安装来源、修改 prefix、清理旧目录。
- 重新打开终端并验证。 让新的 shell 读取配置后，再检查
node -v、npm -v、command -v node、command -v npm和 prefix 是否符合预期。 - 验证全局命令。 安装课程需要的工具后，用
command -v 工具命令检查终端能否找到它；再按该工具自己的说明运行帮助或版本检查。 - 检查项目没有意外变化。 回到课程项目，运行
git status --short查看文件改动，再按课程步骤运行项目自己的安装、测试或启动命令。全局安装和项目依赖安装不是同一件事，若项目命令失败，应另行检查项目依赖。
SECTION 05常见问题
Mac 上全局安装报 EACCES 怎么办？
先确认失败命令是否带 -g，再查看 npm 全局 prefix 和 Node.js、npm 的路径。若目标确实是无权写入的全局目录，优先评估 Node 版本管理器；需要保留原安装方式时，再按 npm 官方说明将目录调整到用户目录并核对 PATH。不要把项目依赖安装错误直接当成全局权限问题。
Node.js 24 的权限错误是版本本身的问题吗？
不能只凭 EACCES 判断是 Node.js 24 的问题。错误通常说明当前操作无法访问目标目录；安装残留、路径混用或全局目录权限都值得检查。先对照课程要求核验 Node.js 和 npm 实际路径，再判断是否需要修复安装方式。Node.js 版本状态以官方发布页为准。
没有管理员权限，还能使用全局命令吗？
有条件可以：目标目录必须是当前账户可写的位置，终端也必须能从 PATH 找到命令。npm 文档给出的方向包括版本管理器和用户目录配置；学校管理设备可能限制更改 shell 文件或安装工具。如果遇到限制，联系管理员或课程教师确认，不要绕过设备管理策略。
修复权限后，怎么确认课程项目仍正常？
在项目目录先查看 git status --short，确认项目文件没有意外变化；接着检查 Node.js 版本是否符合课程要求，再按课程原步骤运行项目。若系统终端正常、编辑器终端却找不到命令，分别检查两边的 command -v 和 PATH；这可能是终端环境不同，并不自动说明项目损坏。
SECTION 06如果错误仍然存在，按症状停下或转查
- 仍然显示 EACCES： 回看错误指向的实际目录。若它仍是系统位置，或你无法确认目录归属，停止继续改权限，把完整命令和检查结果交给管理员。
- 安装似乎成功，但找不到命令： 重新检查全局安装前缀下的命令目录是否在 PATH 中；再确认系统终端和编辑器终端调用的是不是同一套 Node.js、npm。
- 全局工具能运行，但项目安装失败： 这不是同一个故障。检查当前工作目录、项目说明和项目依赖错误，不要重复修改全局 prefix。
- 课程项目结果异常： 对比修改前后的项目文件状态，按课程要求恢复意外变更；如果无法判断变更来源，先暂停安装和清理操作。
如果你现在使用的是学校电脑，主要问题可能是配置权限受限，而不是缺少一个万能的 npm 命令。MACNOX 提供的是远程真实 Mac 使用方式，能给你一套可使用的 macOS 学习环境，但不会自动替你修好项目配置；若你确实需要在 Mac 上完成课程练习，可以先了解 MACNOX 的 Mac 环境与服务入口，再查看 套餐与价格信息。如果课程长期要求稳定、持续运行的开发机，或你需要直接连接本地物理设备，先比较自有 Mac 与学校资源；如果只是需要临时完成 Mac 上的练习，再判断远程环境是否合适。
SECTION 07常见问题 FAQ
Mac 上 npm 全局安装提示 EACCES，应该先做什么？
先记下触发错误的完整命令，再分别查看 node、npm 的实际路径和 npm 的全局 prefix。若命令没有使用 -g，通常应先按项目依赖安装问题排查；只有全局目标目录不可写时，才考虑更换安装方式或把目录改到自己的用户目录。不要先用 sudo 重试，也不要递归修改系统目录权限。
Node.js 24 的 npm 全局安装权限错误通常由什么造成？
常见原因是 npm 要把全局包写进当前账户无权修改的安装目录；也可能是终端同时找到不同安装来源的 Node.js 与 npm，或者编辑器使用了另一套 PATH。查看 command -v、版本号和 npm config get prefix 后，再对照课程要求判断。EACCES 表示访问被拒绝，但单凭错误本身无法证明是哪一种原因。
没有 Mac 管理员权限，还能安装 npm 全局命令吗？
有时可以，但要看设备管理政策和当前安装方式。npm 官方给出的方向包括使用 Node 版本管理器，或把全局目录配置到你有权限写入的用户目录，并让 shell 能找到对应命令。如果这是学校管理的 Mac、配置文件受限制，或课程要求固定环境，不要尝试绕过限制；先联系管理员或课程教师确认可行路线。
修复 npm 权限后，怎么确认课程项目没有被影响？
先在项目目录查看 git status --short，确认修复过程没有意外改动项目文件；再检查 node -v、npm -v 和课程指定的 Node.js 版本，按课程步骤运行项目的依赖安装或测试命令。最后在实际使用的编辑器终端核对环境，并检查课程需要的全局命令是否能被找到。若项目出现新的依赖错误，先区分它与原来的全局权限问题。