已安装本地Prettier但命令无法执行，求排查方案

问题描述 #

package.json的devDependencies中已配置"prettier": "^2.8.4"，执行npm i完成安装后，直接运行prettier命令提示bash: prettier: command not found；执行npx prettier -v也报错，临时路径/var/folders/q6/npwl_7xj4wg91lg06f8pnnfh0000gn/T/npx-b98a4fce.sh不确定是否正常。使用nvm管理环境，Node版本为v16.17.1，npm版本为v8.15.0。全局执行npm install -g prettier后Prettier可正常使用，但本地安装无法生效，求问题原因及调试方法？

问题原因及解决方法 #

核心原因 #

1. 本地可执行文件未在系统PATH中：npm本地安装的包，其可执行文件默认存放在项目的node_modules/.bin目录下，这个路径不在系统默认的PATH里，直接输入prettier命令时系统无法找到。
2. npx缓存或版本兼容问题：npm v8.15.0对应的npx版本可能存在临时脚本执行的bug，或者npx缓存异常导致无法正确定位本地包。
3. 安装不完整或环境冲突：npm i过程中可能因缓存、网络问题导致prettier未正确安装；nvm管理多Node版本时，可能出现npm配置路径异常。

调试及解决步骤 #

• 验证本地安装完整性
  检查项目根目录下的node_modules/prettier是否存在，且node_modules/prettier/bin/prettier.js文件正常；同时确认node_modules/.bin/prettier软链接指向正确路径。
• 直接调用本地命令
  执行./node_modules/.bin/prettier -v，如果能正常输出版本号，说明本地安装没问题，只是PATH未包含node_modules/.bin。
• 临时/永久配置PATH
  • 临时生效：终端执行export PATH=$PATH:./node_modules/.bin，之后再测试prettier -v。
  • 永久生效：将上述命令添加到shell配置文件（如~/.bashrc、~/.zshrc），重启终端后生效。
• 修复npx异常
  • 清除npx缓存：执行npx clear-npx-cache，再尝试npx prettier -v。
  • 强制使用本地版本：执行npx --no-install prettier -v，避免npx尝试下载全局版本。
• 检查npm和nvm环境
  • 执行npm bin，确认输出为项目根目录的node_modules/.bin，若不是则说明npm配置异常。
  • 执行nvm current确认当前Node版本为v16.17.1，避免版本切换导致环境不一致。
  • 重新安装依赖：删除node_modules和package-lock.json，执行npm cache clean --force后重新运行npm i。

内容的提问来源于stack exchange，提问作者Dashiell Rose Bark-Huss