Nx项目中Rollup配置导致资源文件复制错误的解决方案

问题背景

在使用Nx构建工具创建JavaScript库项目时，开发者可能会遇到一个关于资源文件复制的配置问题。当通过命令生成一个使用Rollup作为打包工具的库项目时，自动生成的Rollup配置文件会导致资源文件从错误的位置被复制。

问题现象

通过Nx生成器创建的Rollup配置文件默认会将项目根目录下的README.md文件复制到输出目录，而不是当前库项目目录下的README.md文件。这会导致发布库时包含错误的文档内容。

技术分析

Rollup的assets配置项用于指定需要复制的静态资源文件。在默认生成的配置中：

assets: [{ input: '.', output: '.', glob: '*.md' }]

这里的input: '.'指向的是执行构建命令时的工作目录，通常是项目根目录，而不是库项目所在的子目录。

解决方案

有两种更可靠的解决方案：

1. 使用Node.js的__dirname变量：

assets: [{ input: __dirname, output: '.', glob: '*.md' }]

2. 使用Nx提供的特殊标记{projectRoot}：

assets: [{ input: '{projectRoot}', output: '.', glob: '*.md' }]

这两种方式都能确保从正确的项目目录复制资源文件。

最佳实践建议

对于使用Nx构建工具的项目，建议采用以下策略：

1. 在创建新库项目后，立即检查Rollup配置文件中的资源路径配置
2. 优先使用{projectRoot}标记，因为它与Nx生态系统集成度更高
3. 对于需要复制的多种类型资源，可以扩展glob模式或添加多个assets条目
4. 在项目文档中明确说明资源文件的处理方式，便于团队协作

总结

Nx工具链虽然强大，但在某些细节配置上仍需开发者注意。理解Rollup打包过程中资源文件的处理机制，能够帮助开发者避免发布错误的内容。通过使用正确的路径指定方式，可以确保构建过程按预期工作，产出符合要求的发布包。