构建dsi.cfw.guide时Vitepress报错：本地运行出现Bus error

问题场景 #

• 运行环境：arm64架构手机，Termux内的Proot Ubuntu发行版
• 执行操作：克隆dsi.cfw.guide代码仓库后，运行npm run docs:dev
• 出现报错：Bus error

可能的解决方法 #

• 检查Node.js版本兼容性
  VitePress要求Node.js为LTS版本（如18.x、20.x），执行node -v查看当前版本，若不符合，重新安装对应版本的Node.js。

• 调整Proot内存限制
  Bus error常和内存不足或内存访问异常相关，Proot默认内存限制可能偏低。启动Proot时可增加内存参数，例如：

  proot --memory 2G -b /dev -b /proc -b /sys -w /root -r ubuntu-fs /bin/bash
  

  （根据你的实际Proot启动命令调整内存数值）

• 重装依赖并清理缓存
  先移除现有依赖和锁文件，清理npm缓存后重新安装：

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

  完成后再次执行npm run docs:dev。

• 禁用VitePress的优化特性
  编辑项目根目录的vitepress.config.js，添加配置禁用可能引发arm64兼容性问题的优化：

  export default {
    vite: {
      optimizeDeps: {
        disabled: true
      },
      build: {
        target: 'es2015'
      }
    }
  }
  

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