在 npm scripts 中传递参数,需要在脚本命令后添加双连字符 --,随后跟上具体的键值对或位置参数。npm 会将 -- 之后的内容原封不动地传递给底层执行的 node.js 进程,并通过 process.argv 数组进行访问。这种方式适用于所有基于 node.js 的 cli 工具,如 webpack、babel 或自定义脚本。

如何获取传递的位置参数和标志位
通过 process.argv 可以获取命令行传入的参数。前两个元素分别是 Node.js 路径和脚本路径,从第三个元素开始才是用户输入的参数。例如运行 npm run test -- arg1 arg2,process.argv[2] 将是 arg1,process.argv[3] 将是 arg2。对于带等号的标志位如 --env=prod,它会被解析为 env 和 prod 两个连续的元素。

const args = process.argv.slice(2);
console.log('Arguments:', args); // [ 'arg1', 'arg2' ]
// 处理 key=value 格式
const envIndex = args.indexOf('--env');
if (envIndex !== -1) {
const envValue = args[envIndex + 1];
console.log('Environment:', envValue);
}
如何处理复杂的对象或 JSON 参数
当需要传递复杂结构如 JSON 对象时,直接传递字符串会导致 shell 转义问题。最佳实践是将 JSON 作为单个参数传递,并在脚本中使用 JSON.parse() 解析。例如运行 npm run build -- --config={"port":8080},注意外层引号需根据操作系统调整。Node.js 接收到的将是完整的 JSON 字符串,解析后即可得到对象。
FilePond 是一个 JavaScript 文件上传库,支持通过拖拽、粘贴和 API 方式处理文件、目录、URL 和 Data URI。它包含内置的图像优化功能、异步分块上传功能,并提供了适用于 React、Vue、Angular 和 Svelte 的适配器。

const configStr = process.argv.find(arg => arg.startsWith('--config='));
if (configStr) {
const config = JSON.parse(configStr.split('=')[1]);
console.log('Config:', config);
}
为什么某些情况下参数会被截断或丢失
参数丢失通常是因为未正确使用 -- 分隔符,或者参数中包含特殊字符未被正确转义。Windows 和 Unix 系统对引号和空格的解析规则不同,可能导致参数被拆分。建议在跨平台项目中使用 cross-env 或确保参数用双引号包裹。此外,npm 本身不会解析 -- 后的内容,完全由目标脚本处理,因此需确保脚本能正确消费这些参数。
Java免费学习笔记:立即使用
解锁 Java 大师之旅:从入门到精通的终极指南










