diff --git a/tests/test_ps1_bom.py b/tests/test_ps1_bom.py new file mode 100644 index 0000000..758088b --- /dev/null +++ b/tests/test_ps1_bom.py @@ -0,0 +1,53 @@ +# -*- coding: utf-8 -*- +"""PowerShell 脚本必须带 UTF-8 BOM。 + +背景(10-04 坑 6, 10-13 又踩了一次): +`scripts/*.ps1` 里有中文注释和中文提示串。文件没有 BOM 时, Windows PowerShell +5.1 会按**系统 ANSI 代码页(GBK)** 解析, 中文被拆成乱码字节, 于是报出一堆 +"行号对不上"的语法错, 而且报的行号会指到别的语句上, 极难定位。 + +更坑的是: 用 pwsh 7 / PowerShell Core 做的"语法检查"能正确处理无 BOM 的 UTF-8, +会给出假的 ✅。所以必须用字节级检查, 不能靠解析器。 + +编辑器(包括各种自动改写工具)保存时常把 BOM 丢掉, 所以这里做成测试而不是一次性修复。 +""" +import os +import sys +import unittest +from pathlib import Path + +ROOT = Path(__file__).resolve().parents[1] +SCRIPTS = ROOT / 'scripts' +BOM = b'\xef\xbb\xbf' + + +class Ps1BomTest(unittest.TestCase): + + def files(self): + return sorted(SCRIPTS.glob('*.ps1')) + + def test_there_are_ps1_files_to_check(self): + # 防止 glob 路径写错导致这个测试空转(空列表会让下面全部通过) + self.assertTrue(self.files(), '没找到 scripts/*.ps1, 测试本身失效了') + + def test_every_ps1_starts_with_utf8_bom(self): + bad = [] + for p in self.files(): + head = p.read_bytes()[:3] + if head != BOM: + bad.append('%s (前 3 字节: %s)' % (p.name, head.hex(' ').upper())) + self.assertFalse( + bad, + '这些 .ps1 缺 UTF-8 BOM, Windows PowerShell 5.1 会按 GBK 解析中文而报错:\n ' + + '\n '.join(bad) + + '\n修复: 读成 UTF-8 后以 utf-8-sig 写回。') + + def test_no_ps1_contains_gbk_decodable_mojibake(self): + """带 BOM 的文件读出来不应有乱码替换符。""" + for p in self.files(): + text = p.read_text(encoding='utf-8-sig') + self.assertNotIn('\ufffd', text, '%s 含替换符, 可能编码已损坏' % p.name) + + +if __name__ == '__main__': + unittest.main()