commander.js开发的CLI中node-fetch忽略查询字符串问题咨询

• 将node-fetch加入package.json的bundledDependencies配置数组，npm发布时会把对应版本的node-fetch直接打进你的CLI安装包，安装时不会从外部拉取依赖，从根源避免用户本地版本覆盖。
• 如果你使用esbuild、rollup、webpack这类工具构建CLI单文件入口，开启依赖打包配置，把node-fetch直接编译进最终的入口文件，完全消除运行时依赖加载的外部路径影响，所有内置依赖都是你指定的版本。
• 不要将node-fetch声明为peerDependencies，该配置默认优先调用用户当前项目下安装的依赖版本，不符合CLI工具的依赖隔离需求。
• 可以在依赖引入时强制指定查找路径，使用require(require.resolve('node-fetch', { paths: [__dirname] }))写法，强制从CLI脚本所在目录开始查找依赖，不会向上递归匹配用户本地安装的其他版本node-fetch。
• 额外可在CLI启动时增加版本校验逻辑，读取当前加载的node-fetch版本和你package.json中声明的版本比对，不一致时直接抛出明确错误提示，避免静默运行出现异常。

• Node.js版本兼容问题：部分低版本Node.js的内置URL解析逻辑存在缺陷，如果你是手动拼接查询字符串到URL路径中，遇到带未编码特殊字符的场景时，会直接截断?后面的内容，建议统一使用URLSearchParams构造查询参数，绑定到URL实例后再传入fetch，不要手动拼接字符串。
• 代理配置影响：部分用户环境配置了HTTP/HTTPS全局代理，代理工具的转发规则如果存在路径匹配逻辑，很容易主动丢弃查询字符串部分，导致发往API的请求不带参数。
• 代码隐性逻辑问题：如果你的代码中存在URL改写逻辑，比如部分分支下只取了URL的origin+pathname部分，忘记拼接search查询串，会在特定场景下出现参数丢失。
• 特殊字符未编码：部分旧版node-fetch对URL格式要求严格，如果传入的查询字符串中存在未编码的中文、空格、特殊符号，会直接截断?后的内容，不会携带查询参数发起请求。
• 全局fetch被篡改：部分用户本地的其他工具会注入全局的fetch实现（也就是monkey patch），替换了你调用的node-fetch逻辑，导致参数处理逻辑异常。
• 服务端日志问题：部分用户反馈的参数丢失实际上是服务端接收、打印日志时的逻辑问题，并非请求侧没有发送，可以让用户在本地开抓包工具确认请求是否真的没有携带查询参数。

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