简介
rollup-plugin-includepaths 是一个用于 Rollup 构建工具的插件，它可以让你在打包过程中轻松引用项目中的文件和依赖。该插件旨在解决 Rollup 在打包时无法解析相对路径的问题，也能帮助你避免手动指定绝对路径。
安装
使用 npm 或 yarn 安装 rollup-plugin-includepaths：
npm install --save-dev rollup-plugin-includepaths
或者
yarn add --dev rollup-plugin-includepaths
基本用法
在 Rollup 配置文件中导入插件：
import includePaths from 'rollup-plugin-includepaths';
然后在 plugins 数组中添加该插件：
export default { // ... plugins: [ includePaths({ paths: ['src'], }), ], };
以上代码指定了 src 目录为默认的搜索路径。当你在代码中引用模块时，Rollup 将自动从该目录中查找模块。
高级用法
自定义别名
除了指定默认的搜索路径外，你还可以设置自定义别名，以便更容易地引用特定的模块。例如，如果你想用 @components 引用 src/components 目录下的模块，可以这样配置：
includePaths({ paths: ['src'], customPaths: { '@components': 'src/components' }, })
这样，在代码中引用模块时，你只需要使用 @components 就能指向该目录下的模块了。
自定义解析器
默认情况下，rollup-plugin-includepaths 使用 Node.js 的解析器来查找模块。但是，如果你在项目中使用了自定义的解析器，你可以通过设置 resolve 选项来指定使用自定义解析器。
例如，如果你想使用 Yarn PnP 解析器，可以这样配置：
includePaths({ paths: ['src'], resolve: ['yarn-pnp-webpack-plugin'], })
指定搜索顺序
当多个目录都包含同名模块时，rollup-plugin-includepaths 默认按照目录在数组中出现的顺序进行搜索。如果你想改变搜索顺序，可以通过设置 order 选项来指定。
例如，如果你想优先搜索 src/components 目录下的模块而不是 node_modules 中的模块，可以这样配置：
includePaths({ paths: ['src'], order: ['src/components', 'node_modules'], })
这样，在搜索同名模块时，rollup-plugin-includepaths 将首先查找 src/components 目录下的模块，如果没有找到才会去查找 node_modules 中的模块。
示例代码
下面是一个简单的示例，演示了如何使用 rollup-plugin-includepaths：
-- -------------------- ---- ------- ------ ------------ ---- ----------------------------- ------ ------- ---- ------------------------------ ------ ------- - ------ --------------- ------- - ----- ----------------- ------- ------ -- -------- - -------------- ------ -------- ------------ - -------------- ---------------- -- ------ --------------- ---------------- -------- ---------------------------- --- ---------- -- --展开代码
以上配置文件指定了 src 目录为默认的搜索路径，并设置了 @components 别名，指向 src/components 目录。它还将优先搜索 @components 目录下的模块而不是 node_modules 中的模块，并使用 Yarn PnP 解析器来查找模
来源：JavaScript中文网 ，转载请注明来源 https://www.javascriptcn.com/post/42376
