Remix.js中remix build未自动生成build目录的原因及解决方法

1. 核对remix.config.js核心配置 #

打开项目根目录的remix.config.js，确认buildDirectory和publicBuildDirectory的配置是否正确，默认配置应如下：

/** @type {import('@remix-run/dev').AppConfig} */
module.exports = {
  buildDirectory: "./build",
  publicBuildDirectory: "./public/build",
  // 其他配置项...
};

如果buildDirectory被修改、注释或与publicBuildDirectory重复，会导致build目录无法正常生成。

2. 统一Remix依赖版本 #

检查@remix-run/dev和对应运行时依赖（如@remix-run/node）的版本是否一致，版本不匹配会引发构建流程异常。执行命令查看版本：

yarn list @remix-run/dev @remix-run/node

若版本不一致，重新安装统一版本：

yarn add @remix-run/dev@latest @remix-run/node@latest

3. 彻底清理缓存后重建 #

除手动删除build和public/build目录，还要清理yarn缓存及Remix专属缓存：

yarn cache clean
rm -rf node_modules/.cache/remix
yarn install
yarn run remix build

4. 确认路由文件有效性 #

检查app/routes目录下是否存在符合规范的路由文件（如_index.jsx、about.jsx等），若路由目录为空或文件命名不符合Remix要求，构建时不会生成routes相关输出。

5. 查看详细构建日志排查错误 #

执行构建命令时添加--verbose参数，获取完整日志信息，定位隐藏的报错：

yarn run remix build --verbose

日志中的语法错误、文件缺失、权限问题等信息，会直接指明构建失败的根源。

6. 检查项目目录权限 #

确保当前用户对项目目录拥有读写权限，Linux/macOS系统可执行以下命令调整权限：

chmod -R 755 ./your-project-folder

内容的提问来源于stack exchange，提问作者O.G Bellz