如何彻底移除React Native项目中安装的Wix react-native-navigation库

第一步：移除npm依赖包 #

根据你使用的包管理器执行对应卸载命令：

• npm：npm uninstall react-native-navigation
• yarn：yarn remove react-native-navigation
• pnpm：pnpm remove react-native-navigation

第二步：回退Android端配置改动 #

对应安装时的修改，逐一恢复以下文件：

• 打开android/app/src/main/java/[你的项目包名路径]/MainActivity.java，移除所有RNN相关的导入语句、类继承修改，恢复为React Native默认的MainActivity实现，删除RNN专属的SplashActivity相关配置
• 打开android/app/src/main/AndroidManifest.xml，移除RNN添加的Activity声明、自定义主题配置，恢复默认的MainActivity作为应用入口
• 打开android/build.gradle，移除RNN要求添加的maven仓库地址、gradle插件配置
• 打开android/app/build.gradle，删除dependencies块中RNN的依赖声明，回退RNN要求修改的compileSdk、targetSdk等版本配置
• 删掉android目录下所有RNN自动生成的额外类文件、配置文件

第三步：回退iOS端配置改动 #

• 打开ios/Podfile，移除RNN的pod引入语句，之后执行cd ios && pod install && cd ..移除Pod依赖
• 打开Xcode项目，在Build Phases中删除RNN添加的编译脚本、链接库配置
• 修改AppDelegate.h、AppDelegate.mm（或AppDelegate.m），移除所有RNN相关的导入、初始化逻辑，恢复为React Native默认的AppDelegate实现
• 打开Info.plist，删除RNN添加的所有自定义配置项
• 回退安装RNN时修改的Xcode项目编译参数、签名配置等内容

第四步：清理项目残留与缓存 #

• 全局搜索项目代码中所有导入react-native-navigation的语句，以及调用RNN API的逻辑，全部删除或替换为其他导航方案的代码
• 执行缓存清理操作，避免构建时报错：
  • 清理Metro缓存：npx react-native start --reset-cache
  • 清理Android构建缓存：cd android && ./gradlew clean && cd ..
  • 清理iOS构建缓存：直接删除ios/build文件夹
• 可删除根目录的node_modules文件夹，重新执行包安装命令，验证没有RNN相关的依赖残留

如果你使用Git管理代码，可直接对比安装RNN前后的提交记录，逐行回退所有改动，是效率最高、不会遗漏的方案。

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