bash-defensive-patterns

Bash 防御性模式

提供全面指南，介绍如何使用防御式编程技术、错误处理和安全最佳实践编写可用于生产环境的 Bash 脚本，以避免常见问题并确保可靠性。

在以下情况下使用此技能

• 编写生产环境自动化脚本
• 构建 CI/CD 流水线脚本
• 创建系统管理工具
• 开发具备错误恢复能力的部署自动化
• 编写必须安全处理边缘情况的脚本
• 构建易于维护的 Shell 脚本库
• 实施全面的日志记录和监控
• 创建必须兼容不同平台的脚本

在以下情况下不要使用此技能

• 只需要一条临时 Shell 命令，而不是脚本
• 目标环境严格要求仅使用 POSIX sh
• 任务与 Shell 脚本或自动化无关

说明

1. 确认目标 Shell、操作系统和执行环境。
2. 从一开始就启用严格模式和安全默认设置。
3. 验证输入、为变量加引号，并安全处理文件。
4. 添加日志记录、错误陷阱和基本测试。

安全

• 除非有确认或试运行标记，否则避免执行破坏性命令。
• 除非确有必要，否则不要以 root 身份运行脚本。

详细模式、检查清单和模板请参阅 resources/implementation-playbook.md。

资源

• resources/implementation-playbook.md：包含详细模式、检查清单和模板。

限制

• 仅当任务明确符合上述范围时，才使用此技能。
• 不要将输出视为环境特定验证、测试或专家审查的替代品。
• 如果缺少必要的输入、权限、安全边界或成功标准，请暂停并请求澄清。