Windows 上跑脚本,我踩过的五个不报错的坑

举报
yd_219023509 发表于 2026/11/17 08:07:04 2026/11/17
【摘要】 编码、BOM、DPAPI、CDP: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. 失败的时候,有没有一条明确的、能看懂的失败信息?

这三条任意一条答不上来,就还不是"验证过"。

【声明】本内容来自华为云开发者社区博主,不代表华为云及华为云开发者社区的观点和立场。转载时必须标注文章的来源(华为云社区)、文章链接、文章作者等基本信息,否则作者和本社区有权追究责任。如果您发现本社区中有涉嫌抄袭的内容,欢迎发送邮件进行举报,并提供相关证据,一经查实,本社区将立刻删除涉嫌侵权内容,举报邮箱: cloudbbs@huaweicloud.com
  • 点赞
  • 收藏
  • 关注作者

评论(0)

0/1000
抱歉,系统识别当前为高风险访问,暂不支持该操作

全部回复

上滑加载中

设置昵称

在此一键设置昵称,即可参与社区互动!

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。

*长度不超过10个汉字或20个英文字符,设置后3个月内不可修改。