发布React Native组件库后调用报错，求问题排查与资源推荐

一、报错原因排查 #

• 检查打包配置是否正确
  开发时组件库依赖本地源码，但发布到npm必须确保所有代码被正确编译。查看package.json里的main、module、types字段，确认它们指向编译后的文件（比如用TypeScript的话，main应该是dist/index.js，types是dist/index.d.ts），而不是源码里的index.ts。
• 确认导出逻辑无问题
  你替换了index.ts只导出createRComps，要确保这个方法内部没有引用未被打包的模块，也没有在React Native环境初始化完成前调用内部API。Cannot read property 'createNode' of null这类报错，大多是组件脱离了React Native上下文，或者内部方法调用时机不对导致的。
• 检查npm发布内容完整性
  执行npm pack生成本地包，解压后看看有没有包含所有编译文件、资源文件，以及package.json里的依赖声明是否正确。别忘了设置peerDependencies声明React、React Native的版本要求，不然安装时可能出现版本不兼容。
• 排查create-react-native-library工具配置
  用这个工具时，要调整tsconfig.json或metro.config.js，确保打包时包含所有组件代码，排除测试文件、示例源码这类不必要的内容。

二、React Native组件库导出规范要点 #

• 入口文件导出清晰
  入口文件（比如index.ts）要明确导出所有对外暴露的内容，示例：

  export { createRComps } from './src/createRComps';
  // 有单独组件的话也可以按需导出
  export { Button } from './src/components/Button';
  

• 编译配置保证兼容性
  用TypeScript的话，tsconfig.json要把target设为es6及以上，module设为esnext或commonjs，outDir指向编译输出目录，确保编译后的代码能被React Native项目识别。
• 正确配置package.json核心字段
  • main: 指向编译后的CommonJS入口文件（如dist/index.js）
  • module: 指向ES模块入口文件（如dist/index.esm.js）
  • types: 指向类型定义文件（如dist/index.d.ts）
  • peerDependencies: 声明依赖的React、React Native版本，示例：

    "peerDependencies": {
      "react": ">=16.8.0",
      "react-native": ">=0.60.0"
    }
    

• 避免直接依赖React Native内部API
  组件库要基于React Native的公开API开发，别直接调用createNode这类内部方法，不然很容易因为版本更新或环境初始化问题出现报错。

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