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
相关产品推荐
相关产品推荐

