fix(installer): 安装器脚本不能带 BOM —— 它会拼进大脚本中间让 makensis 报 Invalid command

构建机上真实失败:`Invalid command: "?;"` / `Error in script "<stdin>" on line 83`。
本机单编这个脚本一切正常,只有 electron-builder 出包才炸。

根因:electron-builder 把「它的共享头部 + 我们的脚本」拼成一个整脚本、经 stdin 喂给 makensis,
而 Node 的 readFileSync(…, 'utf8') **不会**吃掉文件开头的 BOM —— 那个 U+FEFF 落在拼接结果
中间某一行的行首,makensis 就把它当成命令名的一部分(控制台显示成问号)。

- 去掉 console/installer/installer.nsi 的 UTF-8 BOM
- deploy/prepare-extra.mjs 的检查反向:从「必须有 BOM」改成「必须没有 BOM」,并把原因写进注释,
  避免下一个人再按直觉加回去;中文编码改由 makensis 的 -INPUTCHARSET UTF8 保证
  (electron-builder 本来就会传这个参数,本机手工编译也要带)

验证:无 BOM → prepare-extra 退出 0;临时加回 BOM → 退出 1 且提示准确。
This commit is contained in:
AskaEth committed 2026-09-13 15:25:01 +08:00
1 parent 877ff15823
commit 9fee6f2da5
2 files changed
+12 -8

No files matched your search

+11 -7
View File
@@ -34,18 +34,22 @@ for (const doc of docsToStage) {
}
// ---- 1b. 自绘安装器脚本的编码检查 -------------------------------------------
// 本机手工跑 makensis 时必须带 UTF-8 BOM,否则脚本里的中文直接被判成 Bad text encoding;
// electron-builder 那边传了 -INPUTCHARSET UTF8,构建机上没 BOM 也能过 —— 两边口径不一致,
// 出问题时只会表现为「本地编不过、构建机编得过」这种最难查的差异,所以统一要求带 BOM。
// 这条检查要求**没有** BOM —— 方向反直觉,但踩过一次真实的构建失败:
// electron-builder 把「它自己的共享头部 + 我们的脚本」拼成一个整脚本、经 stdin 喂给 makensis,
// 而 Node 的 readFileSync(…, 'utf8') **不会**吃掉文件开头的 BOM:那个 U+FEFF 会落在拼接结果
// 中间某一行的行首,makensis 报 `Invalid command: "?;"`(BOM 被控制台显示成问号),
// 且报的是拼接后的行号 —— 本地单编这个脚本时一切正常,只有构建机才炸,极难定位。
// 中文编码由 makensis 的 `-INPUTCHARSET UTF8` 保证(electron-builder 会传这个参数);
// 本机手工编译时同样带上它,**不要靠加 BOM**。
const installerScript = join(root, 'console', 'installer', 'installer.nsi')
if (existsSync(installerScript)) {
const head = readFileSync(installerScript).subarray(0, 3)
if (!(head[0] === 0xef && head[1] === 0xbb && head[2] === 0xbf)) {
console.error(` [installer] ${installerScript} 缺少 UTF-8 BOM:本机 makensis 会报 Bad text encoding`)
console.error(' [installer] 修复:用编辑器另存为「UTF-8 with BOM」,或跑 python3 -c "…" 补 BOM')
if (head[0] === 0xef && head[1] === 0xbb && head[2] === 0xbf) {
console.error(` [installer] ${installerScript} 带了 UTF-8 BOM:它会被拼进大脚本中间,`)
console.error(' [installer] 构建时 makensis 报 Invalid command: "?;"。请另存为不带 BOM 的 UTF-8。')
process.exit(1)
}
console.log(' installer script has UTF-8 BOM')
console.log(' installer script has no BOM (required by the build)')
}
// ---- 2. installer custom script ---------------------------------------------