Agent Skills
返回列表
PowerShell GBK 编码避坑

PowerShell GBK 编码避坑

开发编程 更新于 2026.08.29

将以下提示词粘贴到你的 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」写成可复用约束