React Native发布版崩溃：未知模块./locale/pt-br（momentjs本地化问题）

我之前也踩过完全一样的坑！DEBUG模式下运行毫无问题，切到Release就直接崩溃，ADB Logcat报ReactNativeJS: Requiring unknown module "./locale/pt-br"，根源就是moment.js的locale文件在Release打包时被Metro打包器默认剔除了，而react-native-calendar-strip组件内部调用updateLocale时会尝试加载对应locale文件，找不到就触发了崩溃。

给你几个亲测有效的解决办法，按需选择就行：

方法1：显式引入需要的moment locale（最推荐） #

直接在项目入口文件（比如App.js或index.js）里手动引入你需要的locale，这样Metro打包时就会把它保留下来，不会被Tree Shaking掉：

// 引入葡萄牙语（巴西）locale
import 'moment/locale/pt-br';

如果需要支持多种语言，就把用到的locale逐个引入：

import 'moment/locale/pt-br';
import 'moment/locale/en-us';
import 'moment/locale/es';

这种方法最高效，只会打包你实际用到的locale，不会增加多余的包体积。

方法2：配置Metro强制包含所有moment locales（多语言全覆盖场景） #

要是你需要支持大量语言，不想一个个手动引入，可以修改metro.config.js，让Metro保留moment的所有locale文件：

const path = require('path');

module.exports = {
  resolver: {
    extraNodeModules: {
      moment: path.resolve(__dirname, './node_modules/moment'),
    },
  },
  transformer: {
    getTransformOptions: async () => ({
      transform: {
        experimentalImportSupport: false,
        inlineRequires: true,
      },
    }),
  },
  // 让Metro监听moment的locale目录，确保打包时不遗漏
  watchFolders: [path.resolve(__dirname, './node_modules/moment/locale')],
};

注意：这种方式会把moment所有的locale文件都打包进去，会略微增加包体积，适合确实需要多语言全覆盖的场景。

方法3：检查react-native-calendar-strip的本地化配置 #

确认你在使用CalendarStrip组件时，正确设置了locale属性，避免组件尝试加载错误的locale：

import CalendarStrip from 'react-native-calendar-strip';

// 确保locale值和你引入的moment locale一致
<CalendarStrip
  locale="pt-br"
  // 其他配置项...
/>

最后一步：清除缓存重新打包 #

不管用哪种方法，都记得清除缓存再重新构建，避免旧的打包文件干扰：

# 清除Metro缓存
npx react-native start --reset-cache

# 清除Android构建缓存
cd android && ./gradlew clean && cd ..

# 重新打包Release版本
npx react-native run-android --mode release

按上面的步骤操作，应该就能解决Release模式下的崩溃问题了！

内容的提问来源于stack exchange，提问作者Fernando Vieira