Windows 上跑脚本,我踩过的五个不报错的坑
在 Linux 上写脚本,报错基本都指向问题本身。到了 Windows,很多坑不报错——它们静默地改变行为,等你发现结果不对时,已经翻了好几层。
这篇记录我最近在 Windows 上写自动化脚本时真正踩到的五个问题,每个都给可复现的现象和验证方式。
一、PowerShell 5.1 读 .ps1 必须带 UTF-8 BOM,否则中文全乱
现象:脚本里写死了中文路径,执行时报"文件不存在",但路径肉眼看上去完全正确。
原因:Windows PowerShell 5.1 在没有 BOM 的情况下,按系统 ANSI 代码页(中文环境是 GBK)解释 .ps1 文件。UTF-8 编码的"桌面"两个汉字被当成 GBK 字节读,变成乱码,路径自然找不到。
验证:
$bytes = [System.IO.File]::ReadAllBytes("script.ps1")
"前三个字节: " + ($bytes[0..2] -join ",")
# EF,BB,BF → 有 BOM;其它 → 没有
修法:写文件时用带 BOM 的 UTF-8(Python 里是 encoding="utf-8-sig")。PowerShell 7 默认按 UTF-8 读,不受影响——但你不能假设生产机器装的是 7。
二、Python 往控制台打印中文,在你的机器上可能直接抛异常
现象:
UnicodeEncodeError: 'gbk' codec can't encode character '\xa0'
原因:Python 输出到非交互的 stdout(重定向到文件、被别的程序捕获)时,编码取自系统区域设置,中文 Windows 上是 GBK。源字符串里只要有一个不在 GBK 覆盖范围内的字符(\xa0 不间断空格、emoji、某些符号),就抛异常。
修法:在脚本入口显式接管 stdout:
import io, sys
sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding="utf-8", errors="replace")
errors="replace" 是保命的:宁可看到一个问号,也别让整段输出因为一个字符而丢掉。或者干脆设环境变量 PYTHONIOENCODING=utf-8。
顺便说,这个错在 Linux 上基本遇不到,所以本地写得好好的一到客户机器上就炸。
三、Get-Content 会把 UTF-8 的加密串读成乱码
这是第二条的变体,但更隐蔽。
场景:用 ConvertFrom-SecureString 把密码加密存成文件,再用 Get-Content 读回来解密。
密文本身是 ASCII 的十六进制串,看起来"不会有编码问题"。但如果文件里有多行、或者你顺手用 Set-Content 写入了中文备注,Get-Content 默认按 ANSI 读,取到的就不是原始内容,ConvertTo-SecureString 报"无法解析"。
修法:Get-Content -LiteralPath $f -Encoding UTF8,并且路径用 -LiteralPath——-Path 会把 [、] 当通配符,路径里有方括号时行为完全不同。
四、加密存储:DPAPI 是"人质式"加密,换机器就解不开
Windows 自带的 DPAPI(ConvertFrom-SecureString / ConvertTo-SecureString)不需要你管密钥,用起来极方便:
$enc = ConvertFrom-SecureString (ConvertTo-SecureString '明文' -AsPlainText -Force)
但它绑的是"当前 Windows 用户 + 当前机器"。这一点常被误解成"加密了就能到处用"。
实测结论:
- 同一用户、同一台机器:可解密,行为稳定
- 换一个 Windows 用户登录:解不开
- 把文件拷到另一台机器:解不开
所以它适合"本机自动化脚本存自己的凭据",不适合"团队共享配置"。要跨机器就得换成真正的密钥管理(环境变量注入、Vault、KMS 之类)。
另外,没人会告诉你的是:验证过一次能解密,不等于以后都能解密。系统重装、用户配置文件迁移、某些企业安全策略变更,都可能让它失效。脚本里必须有一条明确的失败路径,而不是假设它永远可用。
五、自动化浏览器:不要 launch(),要 connect_over_cdp()
用 Playwright 做需要登录态的自动化,常见写法是 chromium.launch() 然后手动登录——每次跑都要重新过验证码、扫码、短信。
实际更稳的做法是让一个 Chrome 常驻,脚本去连它:
chrome.exe --remote-debugging-port=9222 --user-data-dir=D:\work\.profile
b = p.chromium.connect_over_cdp("http://127.0.0.1:9222")
ctx = b.contexts[0]
page = ctx.pages[0] if ctx.pages else ctx.new_page()
好处:
- 登录态在浏览器里,脚本不碰密码
- 需要人工过验证码时,人可以接手同一个窗口
- 脚本崩了不影响浏览器,下一轮直接接着用
代价:你有了一个长期存在的进程和端口。9222 是明文调试端口,任何本机进程都能连上去操作这个浏览器——所以别用它登不想让别人碰的账号,用完关掉,或者至少别在多人共用机器上常开。
顺带一提:browser.close() 只是断开连接,不会关掉那个 Chrome,这一点和 launch() 的直觉不一样,我一开始也搞错过。
最后:一条判断标准
Windows 上的坑有个共同特征——它们不报错,它们产生"看起来对"的结果。
所以判断标准不是"脚本跑完了没有异常",而是:
1. 输出的是不是你要的那几个值?(不是"有没有输出")
2. 换一个入口(不同编码、不同用户、不同路径形态)还成不成立?
3. 失败的时候,有没有一条明确的、能看懂的失败信息?
这三条任意一条答不上来,就还不是"验证过"。
- 点赞
- 收藏
- 关注作者
评论(0)