如何在npm发布包时移除src文件夹及相关优化问题

AI 小北

2026-8-13

关于react-native-animated-dots-carousel的npm包体积优化与发布验证

1. 移除src文件夹是否合理？

完全合理——只要你的package.json中main/module/types等入口字段已经指向lib目录下的编译产物，用户安装后只会使用转译后的代码，src作为源码目录无需发布到npm。唯一例外是如果你的库明确鼓励用户基于源码二次开发，但绝大多数npm包不需要包含源码。

2. 可移除的非必要内容

基于你的当前配置，可进一步精简以下内容：

src目录：确认lib产物完整且可用后，直接从files数组中移除"src"
cpp目录：如果你的React Native库没有用到C++原生逻辑（多数RN组件库仅依赖android/ios原生代码），移除"cpp"条目
配置文件：如果用户不需要复用你的TS/ESLint等配置，可添加排除规则："!**/*.tsconfig.json"、"!**/.eslintrc.js"
冗余测试文件：你已排除__tests__/__fixtures__/__mocks__，保持即可

3. 测试发布后的包形态（零风险验证）

生成模拟包：在项目根目录运行npm pack，会生成一个.tgz压缩包，这就是将要发布到npm的完整内容。解压后可直接检查文件结构是否符合预期
本地安装验证：将生成的.tgz包安装到一个测试RN项目中（npm install ../path/to/your-package.tgz），验证组件功能正常，无模块缺失报错
体积检查：使用npm pack --dry-run查看包体积，或用本地工具快速评估优化效果

4. 优化后的files配置示例

"files": [
  "lib",
  "android",
  "ios",
  // 若cpp目录无用则删除此行
  // "cpp",
  "react-native-animated-dots-carousel.podspec",
  "!lib/typescript/example",
  "!**/__tests__",
  "!**/__fixtures__",
  "!**/__mocks__",
  // 可选：排除开发用配置文件
  "!**/*.tsconfig.json",
  "!**/.eslintrc.js"
]