You need to enable JavaScript to run this app.
优惠活动
大模型
产品
解决方案
定价
更多

Expo项目执行npx expo run:android时遭遇Windows平台CMake路径长度超限错误

Expo项目执行npx expo run:android时遭遇Windows平台CMake路径长度超限错误

嘿,这个问题我太熟了!Windows上的路径长度限制简直是React Native/Expo开发者的噩梦,尤其是用到react-native-reanimated这种嵌套深的依赖时,哪怕你移了项目、开了LongPaths也可能踩坑。我来给你几个亲测有效的方案:

1. 用Windows符号链接把项目"移"到根目录(最推荐)

Windows的符号链接相当于给长路径建一个短的"快捷方式",编译时会用这个短路径来计算长度。操作步骤很简单:

  • 打开管理员权限的命令提示符(CMD/PowerShell都可以)
  • 执行命令创建一个短路径的符号链接,比如把你的项目映射到C:\myapp:
    mklink /D C:\myapp "C:\Users\marin\Documents\10 Projecten\01 programmeer projecten\TEMPLATES\APP TEMPLATE\App-Template\expo-app-template"
    
  • 切换到C:\myapp目录下,再执行npx expo run:android,这样编译时所有路径都会以C:\myapp开头,直接砍掉一大段长度。

2. 强制增大CMake的路径长度限制

既然错误提示说默认是250字符,那我们手动把这个限制调大就行:

  • 打开项目里的android/app/build.gradle文件
  • 找到externalNativeBuild下的cmake配置块(如果没有就手动加),添加路径长度参数:
    android {
      // 其他配置...
      externalNativeBuild {
          cmake {
              arguments "-DCMAKE_OBJECT_PATH_MAX=300"
          }
      }
    }
    
  • 保存后,删除android/.cxx和android/app/build目录清空缓存,再重新执行编译命令。

3. 临时修改react-native-reanimated的CMake配置(应急用)

如果上面两个方法还不行,直接修改依赖的CMake配置:

  • 找到node_modules/react-native-reanimated/android/src/main/cpp/reanimated/CMakeLists.txt
  • 在文件最开头添加一行:
    set(CMAKE_OBJECT_PATH_MAX 300)
    
  • 注意:这个修改是临时的,下次执行npm install或者yarn install会被覆盖,要是想持久化可以用patch-package工具给依赖打补丁。

最后再提两个小细节:

  • 开启LongPaths后一定要重启Android Studio和所有命令行窗口,不然系统不会加载新配置
  • 每次调整路径或配置后,记得清空编译缓存,避免旧路径残留导致的问题

内容来源于stack exchange

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.04.07 11:00:27