babel-node运行React.jsx文件报错，请求协助排查修复

我之前也碰到过这个报错，它一般出现在Babel的模板处理逻辑里，要么是依赖版本不匹配，要么是配置/代码里用了不被识别的占位符。先把你遇到的完整报错信息贴出来方便参考：

root@ip-10-252-14-11:/home/ubuntu/workarea/sourcecode/ntdl# babel-node node/react-render.jsx
/usr/local/lib/node_modules/@babel/core/node_modules/@babel/template/lib/builder.js:86
  throw err;
  ^

Error: Unknown substitution "BODY" given
    at /usr/local/lib/node_modules/@babel/core/node_modules/@babel/template/lib/populate.js:22:15
    at Array.forEach (<anonymous>)
    at populatePlaceholders (/usr/local/lib/node_m...

下面是几个针对性的修复步骤，你可以逐一尝试：

• 统一Babel相关依赖的版本
  这个报错最常见的原因是@babel/core和@babel/template的版本不一致，导致模板系统的API不兼容。你可以先查看当前安装的版本：

  npm list @babel/core @babel/template @babel/node
  

  如果发现版本有差异，把它们统一到同一个大版本（比如都是7.x的最新稳定版）：

  npm install @babel/core@latest @babel/template@latest @babel/node@latest --save-dev
  

• 检查Babel配置文件
  打开你的.babelrc或者babel.config.json，看看有没有引入自定义的Babel插件，或者使用了比较旧的预设。有些第三方插件可能会错误地使用BODY作为模板占位符，而新版Babel不再支持这个写法。如果找到这类插件，要么更新插件到最新版，要么替换成官方维护的替代插件。

• 排查JSX文件中的自定义模板代码
  如果你在react-render.jsx或者它导入的文件里使用了@babel/template的API，比如手动构建AST，检查有没有错误定义BODY作为占位符但没有正确声明的情况。比如正确的占位符声明应该是这样的：

  import template from '@babel/template';
  const buildNode = template(`
    function %%NAME%%() {
      %%BODY%%
    }
  `, { placeholderPattern: /%%([^%]+)%%/ });
  

  如果没有指定占位符规则，Babel默认不识别BODY这种大写的占位符，需要调整写法或者配置占位符模式。

• 清理依赖缓存并重新安装
  有时候缓存的旧依赖会导致奇怪的兼容性问题，你可以试试清空缓存后重装：

  npm cache clean --force
  rm -rf node_modules package-lock.json
  npm install
  

按照这些步骤排查，应该能解决这个报错。

内容的提问来源于stack exchange，提问作者A K Bharath