误解一：手动编辑所有文件
许多开发者在遇到 React Native 项目中的 Git 合并冲突时，第一反应是打开每个报错的文件，手动查找并删除冲突标记（如 <<<、=======、>>>）。这种做法极易引发逻辑错误，尤其是在涉及复杂状态管理或原生模块集成时。一旦误删关键代码，可能导致应用崩溃且难以调试。正确的思路是明确“谁拥有最终决定权”，而非盲目修补。
误解二：忽视节点依赖的冲突
Codex 开发中常见的误区是只关注 JavaScript/TypeScript 源文件的冲突，而忽略了 package.json 和锁文件（如 yarn.lock 或 package-lock.json）中的潜在冲突。如果两个分支安装了不同版本的第三方库，直接合并可能导致依赖树断裂。建议在处理源码冲突前，先确保依赖版本的一致性，必要时使用 npm dedupe 或重新安装依赖来清理环境。
正确策略：利用工具与沟通
避免踩坑的最佳实践是使用可视化合并工具（如 VS Code 内置编辑器或 Sourcetree），它们能清晰展示两边代码的差异，支持逐行选择保留。同时，保持团队沟通至关重要。若冲突涉及核心架构变更，应先与原作者确认意图，再决定取舍。最后，提交前务必运行测试套件，确保合并后的代码在 iOS 和 Android 模拟器上均能正常启动，从而保障开发流程的稳定性。