PowerShell GBK 编码避坑
将以下提示词粘贴到你的 AI 对话框中:
请根据 https://skillhub.cn/install/skillhub.md,安装 @user_7368e5a9/cmd。
技能介绍
问题从哪来
在中文 Windows 上,PowerShell 控制台和重定向(>、>>)往往沿用系统默认编码 GBK(代码页 936)。若你通过 shell 写入本应属于 UTF-8 的文本,中文常会静默乱码——文件照常生成,内容却已在编码层被改坏,排查成本高。
技能如何约束行为
本技能把「写文件」拆成两条可靠路径:
- 优先:用专用文件工具
WriteFile(新建/覆盖)和StrReplaceFile(改已有文件),以确定性 UTF-8 落盘,绕过 shell 默认编码。 - 禁止习惯:
echo ... > file.txt、>>、Set-Content、Out-File未显式-Encoding UTF8等一切经 PowerShell 间接改写字节 的方式——不同区域与 PS 版本默认值不一致,不可依赖。 - 不得已用 Shell:必须在脚本里强制 UTF-8(或走 .NET 直写),并在收尾前打开文件确认中文可读。
- 自检:
chcp若为 936,应视为重定向高危,改回文件工具路径。
边界与注意点
技能面向「Agent/助手在 Windows 上代写配置文件、脚本、文档」的场景,不替代你对业务编码策略的决策;若上游已是 GBK 专有格式,仍需按项目约定处理,不能机械一律 UTF-8。
使用场景
- 在中文 Windows 上让助手生成含中文说明的 `.md` 或 `.json`,需避免 `echo` 重定向导致乱码
- 批量改写项目配置文件时,要求用 `StrReplaceFile` 而非 `Set-Content` 默认编码写入
- 自动化脚本只能走 PowerShell 落盘时,需按技能要求显式 UTF-8 并人工复核文件可读性
- 部署前用 `chcp` 判断代码页 936,决定是否禁止重定向、改走文件工具写 UTF-8
适合人员
- 在 Win10/11 中文系统上配置 Cursor/Agent 写代码与文档的嵌入式工程师,常遇到生成文件中文变问号
- 维护 Windows CI 或本机脚本的 DevOps,需要规范助手落盘方式以免 UTF-8 配置被 GBK 默认编码破坏
- 负责多语言文档仓库的技术写作者,要求 AI 改稿后 diff 里中文仍与编辑器显示一致
- 教新人用 AI 写文件的团队 Tech Lead,想把「禁止 PowerShell 裸重定向写 UTF-8」写成可复用约束