如何为新增自定义函数的table-to-excel项目执行打包构建？

前置准备 #

• 本地安装14.x或16.x版本的Node.js（这两个LTS版本对该项目的旧构建工具兼容性最好，不容易出诡异报错）
• 进入你本地拉取的table-to-excel项目根目录，在终端执行npm install安装全部项目依赖，不要随意升级package.json里标注的依赖版本，避免构建脚本失效

源码修改注意事项 #

• 直接编辑src目录下你要调整的两个JavaScript文件即可，新增自定义函数后，记得在对应文件的导出语句里把你写的新函数加进去，确保构建入口能捕获到你新增的逻辑
• 修改时尽量保持和原有代码的编码风格一致，不要随意改动原有已导出的函数名、入参结构，避免影响原有功能

执行构建 #

• 依赖安装完成、源码改完后，直接在项目根目录终端执行npm run build，该项目已经在package.json里预配置好了rollup打包规则，不需要你额外写打包配置
• 构建过程没有抛出红色报错的话，包含你新增函数的最终产物会直接覆盖生成到dist/tableToExcel.js路径下，同目录还会生成压缩后的生产版本，你直接把这个构建好的js文件嵌入到你的业务项目里就能用
• 如果你需要边改边调试，可以执行npm run dev开启监听模式，src目录下的文件只要保存就会自动触发重新构建，不用每次手动敲构建命令

常见报错排查 #

执行install或者build时报权限错误：关掉终端用管理员/root权限重新打开再执行命令，或者删掉项目里的node_modules文件夹和package-lock.json文件后重新执行依赖安装
构建完dist文件里找不到你新增的函数：回去检查你写的自定义函数有没有在对应src文件的export块中声明，有没有被项目入口文件正确引入
嵌入业务项目后调用新函数报不存在：检查你调用新函数的方式和该库原有API的调用规则保持一致，不要直接调用未导出的内部工具函数

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