React-Native热重载/实时重载初始化Git仓库后失效求助

开发者阿泽

2026-5-21

解决方案：React Native项目添加.git后热重载失效问题

我之前在使用旧版RN/Expo时也碰到过一模一样的情况，结合你用的RN@0.52.0、expo@25.0.0版本，给你几个针对性的解决办法：

先检查.gitignore配置
有时候初始化Git时自动生成的.gitignore可能误加入了项目核心文件/目录的规则，比如不小心把src/、components/或者.js文件给忽略了，导致Metro Bundler无法检测到这些文件的变更。打开项目根目录的.gitignore，把涉及项目业务代码的排除规则删掉就行。
重置Metro缓存并重启服务
缓存异常是这类问题的高发原因，尤其是在添加.git目录后，缓存里的文件监听路径可能出现混乱。直接运行以下命令重置缓存并重启：
```
expo r -c
```
或者用原生RN的命令：
```
react-native start --reset-cache
```
配置Metro排除.git目录的监听
旧版Metro可能会扫描.git目录下的文件，干扰正常的文件变更检测。你可以在项目根目录创建rn-cli.config.js文件，添加以下配置，让Metro跳过.git目录的监听：
```
module.exports = {
  getBlacklistRE() {
    // 排除node_modules和.git目录的监听
    return new RegExp(`(node_modules|\\.git)\/`);
  },
  getWatchFolders() {
    // 指定只监听项目根目录下的文件
    return [__dirname];
  }
};
```
配置完成后重启Expo/RN服务即可。
检查目录权限
如果你是在Linux/macOS环境下开发，.git目录的权限设置可能影响Metro的文件监听能力。可以运行以下命令统一调整项目目录的权限：
```
chmod -R 755 ./
```
最后考虑小版本升级（谨慎操作）
如果你上面的方法都无效，可以尝试升级到同系列的稳定版本，比如把Expo升级到26.0.0（对应RN0.53.0），这类版本兼容问题在后续小版本中可能已经被修复。不过升级前记得备份项目，避免依赖冲突。