如何修复Whitespace was expected错误？无报错路径时的定位指引

• 导出完整错误日志
  默认输出可能截断了关键信息，执行命令把日志全量导出：

  yarn dev > dev-log.txt 2>&1
  

  打开生成的dev-log.txt，搜索Whitespace was expected附近的内容，大概率能找到关联的文件路径或调用栈。

• 重点排查核心配置文件
  这类空格相关的语法错误，90%以上出现在对格式敏感的配置文件里：

  • package.json：检查JSON语法，比如逗号遗漏、引号不闭合、键值对格式错误
  • .yarnrc.yml/.yarnrc：YAML对缩进要求严格，检查有没有不规则的空格、制表符混用
  • 框架配置文件：比如vite.config.js、webpack.config.js、tsconfig.json，查看有没有语法拼写错误（比如对象括号不匹配、模板字符串语法错误）

• 启用调试模式输出
  根据项目使用的构建工具开启调试日志：

  • Vite项目：执行yarn dev --debug，会输出详细的错误追踪栈，包含出错文件的具体位置
  • Webpack项目：执行DEBUG=* yarn dev，强制输出所有调试信息

• 排查最近修改的文件
  如果是近期修改代码/配置后才出现的问题，用版本控制工具（如git）查看最近提交记录，重点检查修改过的文件：

  • JS/TS文件：检查正则表达式、模板字符串、JSX语法里的空格问题
  • 配置文件：对比修改前后的格式差异

• 用语法检查工具精准定位
  借助工具自动扫描语法错误：

  • JSON文件：用jsonlint扫描，命令：jsonlint package.json tsconfig.json
  • YAML文件：用yamllint扫描，命令：yamllint .yarnrc.yml
  • JS/TS文件：用项目自带的eslint扫描，命令：yarn lint

• 排除依赖缓存问题
  偶尔可能是依赖包的缓存文件损坏，执行以下步骤重置：

  rm -rf node_modules yarn.lock
  yarn install
  yarn dev
  

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