如何修复自制React表单NPM包的Source Map解析警告？

1. 调整构建工具的source map生成策略 #

• Rollup配置：如果用Rollup打包，修改rollup.config.js的output配置：
  • 若要保留source map但避免外部文件缺失问题，将sourcemap设为'inline'，这样source map会嵌入到输出的JS文件中，不会生成单独的.map文件；
  • 若不需要source map，直接设sourcemap: false。
• Webpack配置：如果用Webpack，修改output.devtool：
  • 生产环境推荐用'inline-source-map'嵌入source map，或直接设为false关闭生成；
  • 避免使用会生成外部.map文件的配置（如'source-map'），除非你确保这些文件会被包含到发布包中。

2. 确保package.json的files字段包含必要文件 #

在包的package.json里明确指定要发布的文件，避免遗漏source map或构建产物：

"files": [
  "dist",
  "package.json",
  "README.md"
]

如果使用外部source map文件（即单独生成的.map），要确保dist目录下的.map文件被包含在内；如果用inline source map则无需额外配置。

3. 清理无效的source map引用 #

构建完成后检查dist/esm/index.js末尾的注释：

• 如果存在//# sourceMappingURL=index.js.map但对应的.map文件未被发布，要么删除该注释（切换到inline source map），要么将.map文件加入发布文件列表。

4. 同步TypeScript配置的source map设置 #

修改tsconfig.json：

• 若用inline source map，设置"inlineSourceMap": true，同时"sourceMap": false；
• 若关闭source map生成，直接设"sourceMap": false；
• 若保留外部source map，确保"sourceMap": true且生成的.map文件被包含到发布包中。

内容的提问来源于stack exchange，提问作者Juan Carlos Elorriaga