npm link测试本地包提示run-s不是内部或外部命令如何解决

run-s是第三方依赖npm-run-all提供的串行执行npm脚本的命令，报错本质是当前命令行环境无法定位到该命令的可执行文件，结合你用npm link测试本地包、Windows 10 + node15.9.0 + npm8.12.2的环境，常见触发原因有3类：

• 被测试的本地包没有把npm-run-all正确声明在package.json的依赖项里，npm link只会软链当前包本身，不会自动安装未声明的缺失依赖，软链到全局后执行脚本自然找不到对应命令
• Windows 10权限机制导致软链生成异常：普通权限的命令行无法在npm全局目录下创建可执行文件的软链，会直接跳过.cmd脚本的生成步骤；或是npm全局安装路径没有加入系统PATH环境变量，就算文件存在系统也识别不到命令
• 本地依赖目录损坏：之前安装依赖时进程中断、手动删过node_modules里的文件、锁文件版本不匹配，都会导致npm-run-all的可执行文件丢失

按顺序操作即可，每步做完可以先试下执行npx run-s --version，能正常输出版本号就说明问题解决：

1. 补全缺失依赖
   进入被测试本地包的根目录，执行npm ls npm-run-all，如果返回missing提示，直接执行npm install npm-run-all --save-dev，把依赖正式写入devDependencies列表，安装完成后重新执行npm link测试。
2. 修复Windows环境软链问题
   • 执行npm config get prefix拿到npm全局安装的根路径，确认这个路径已经添加到Windows系统的PATH环境变量中，修改完环境变量需要重启命令行工具才会生效
   • 关闭当前命令行，右键选择「以管理员身份运行」打开新的命令行窗口，先执行npm unlink 你要测试的本地包名 -g清理掉之前生成的错误软链，再重新执行npm link
3. 修复损坏的依赖缓存
   如果前两步操作完还是报错，直接删除本地包根目录下的node_modules文件夹和package-lock.json文件，执行npm cache clean --force清空本地npm缓存，再重新执行npm install完整安装所有依赖后重试。

额外提示：node 15.x是非长期支持的奇数版本，和npm 8.x存在已知的兼容性bug，如果后续还出现各类依赖识别异常，可以切换到node 16/18/20的LTS版本，能规避大量环境类问题。

内容的提问来源于stack exchange，提问作者Snow