提高 Windows Shell 脚本执行的可靠性与稳定性
解决 Windows 平台环境下命令行执行不稳定的痛点：通过规范路径引用、统一字符编码处理以及正确使用 PowerShell 调用符，避免脚本在不同版本 Windows 系统中出现执行失败或乱码。
为什么需要这个技能
在 Windows 上运行自动化脚本时，开发者经常遇到一些与 Linux 截然不同的“陷阱”。最常见的问题包括：路径中含有空格导致命令失效、不同版本的 PowerShell 处理重定向时的字符编码不一致（导致日志乱码）、以及误用 CMD 语法在 PowerShell 中执行导致的不可预知错误。
如果 AI 生成的脚本缺乏这些可靠性模式（Reliability Patterns），可能会导致在生产环境或 CI/CD 流水线中出现难以排查的随机失败。
适用场景
- 编写跨版本的 Windows 自动化部署脚本或维护脚本。
- 处理包含空格的复杂文件路径或深度目录（长路径）。
- 需要将 CLI 工具的输出重定向到文本文件并确保编码为 UTF-8。
- 在 PowerShell 环境中调用第三方
.exe二进制文件。
核心工作流
1. 路径与引用规范
Windows 路径中空格极多。必须始终为绝对路径和相对路径加上双引号。
- 错误示例：
dotnet build src/my project/file.fsproj - 正确示例：
dotnet build "src/my project/file.fsproj"
特别注意：在 PowerShell 中，如果可执行文件路径被引号包裹，必须在前面添加调用运算符 & 才能正常启动。
& "C:\Program Files\dotnet\dotnet.exe" build ...2. 编码与重定向处理
旧版 Windows PowerShell 的重定向（>）可能会损坏字节流。
- 推荐做法：在 PowerShell 7.4+ 中直接使用原生重定向。
- 兼容做法：若使用旧版或需确保 UTF-8，使用
2>&1 | Out-File -Encoding UTF8 log.txt。
3. 替代 CMD 语法
为了提高健壮性，应在 PowerShell 脚本中使用完整的 Cmdlet 而非简写别名。
- 删除文件：使用
Remove-Item -Force替代del /f /q。 - 创建目录：使用
New-Item -ItemType Directory替代mkdir。
4. 处理长路径限制
当遇到 Windows 默认的 260 字符路径限制时，使用扩展路径前缀：\\?\C:\Very\Long\Path\...。
下载和安装
下载 windows-shell-reliability 中文版 Skill ZIP
解压后将目录放入你的 AI 工具 skills 文件夹，重启工具后即可使用。具体路径参考内附的 USAGE.zh.md。
你可能还需要
暂无推荐