Parcel无响应且不被识别为命令，npm run build无产物问题求助

以下异常表现均不属于正常行为，对应解决方法如下：

1. npm run build无构建产物、输出调试日志、全局parcel命令无法识别问题 #

该问题通常由调试环境变量触发、依赖安装不完整、Node版本不兼容导致，按以下步骤排查：

• 先清理Node调试环境变量：
  类Unix系统执行：unset NODE_OPTIONS
  Windows系统执行：set NODE_OPTIONS=
  排除强制开启调试模式导致的构建提前终止问题。
• 清理残留依赖后重新安装：
  执行以下命令清理旧的安装内容：

  npm uninstall -g parcel parcel-bundler
  rm -rf node_modules package-lock.json
  # Windows 下删除文件夹对应执行 rmdir /s /q node_modules && del package-lock.json
  

  清理完成后执行npm install重新安装所有依赖，确保Parcel的二进制可执行文件正确写入本地node_modules/.bin目录。
• 确认Node版本符合要求：Parcel 2.0+要求Node版本≥12.13.0，执行node -v查看版本，版本过低则先升级Node runtime。

2. npx parcel build重复安装Parcel、压缩未生效、终端冻结问题 #

该问题通常由本地Parcel安装异常、缓存残留、配置缺失导致，按以下步骤排查：

• 完成上述依赖重装步骤后，本地存在正确的Parcel安装包，npx就不会每次执行都重复下载远程Parcel包。
• 构建前清理缓存：执行rm -rf .parcel-cache dist删除缓存和旧产物，避免旧缓存影响构建结果。
• 补全压缩配置：Parcel默认生产构建会开启压缩，你可以在package.json中显式指定压缩配置保证生效：

  {
    "targets": {
      "main": {
        "minify": true,
        "optimize": true
      }
    }
  }
  

• 终端冻结问题处理：构建时添加--no-source-maps参数禁用sourcemap生成，可加快构建速度同时避免进程挂起：

  npm run build -- --no-source-maps
  

  若执行完成后仍未自动退出，按Ctrl + C手动终止进程即可。

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