如何解耦npm包并替换为源码直引版本？以Pancakeswap前端为例

直接复制源码替换npm包的可行性 #

该方案可以实现，但存在以下约束和风险，需要提前处理：

• 需保证复制的@pancakeswap/sdk、@pancakeswap/uikit源码版本，和当前前端项目依赖的包版本完全一致，避免出现方法不兼容、类型报错等问题
• 需补全两个包自身的所有依赖，包括二者之间的相互依赖、以及它们依赖的第三方npm包，确保版本匹配，避免出现模块缺失报错
• 需同步两个包的编译配置到前端项目中，比如TypeScript配置、Babel插件、样式预处理器规则等，保证项目构建工具可以正常编译这部分源码，避免语法报错、样式不生效等问题
• 手动修改导入路径的工作量较大，且如果项目存在其他间接依赖这两个包的模块，仍然会调用node_modules中的版本，容易出现单包多实例的问题，比如sdk导出的常量实例不相等，导致业务逻辑异常

其他可实现的替代方案 #

除了自行部署私有版本UiKit到npm仓库外，还有以下更低成本的方案可选：

• 使用monorepo workspace能力：通过pnpm或者yarn的workspace功能，将两个包的源码放到项目的workspace目录下，包管理器会自动优先解析本地源码版本，不需要修改任何导入语句，适配性更高
• 使用包链接能力：通过npm link或者yarn link命令，先在本地的两个包源码目录下执行链接注册，再在前端项目中执行对应包的链接命令，开发阶段会直接调用本地源码版本，适合临时调试修改的场景
• 依赖指向fork仓库：fork对应工具库仓库并完成修改后，直接在项目package.json中将这两个包的依赖地址指向你fork后的仓库对应子目录，包管理器支持直接从git仓库安装依赖，不需要发布到公共npm仓库
• 补丁修改：如果仅需要对两个包做少量逻辑修改，可以使用patch-package工具，直接修改node_modules中的对应包代码后生成补丁文件，项目后续安装依赖时会自动应用补丁，是小改动场景下成本最低的方案

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