Community编程与开发github.com

Jamie-BitFlight/bash-52-features

Bash 5.2 版本的功能和改进,附带实用示例。适用于使用 Bash 5.2 功能、变量处理增强、readline 改进,或用户询问 Bash 5.2 变更、新特性及版本特定能力时。

bash-52-features 是什么?

该技能详细记录了 Bash 5.2(2022 年 9 月发布)的功能与改进,包括变量处理增强、Readline 8.2 集成、数组操作改进、参数扩展优化、安全修复和性能提升。它通过大量实际代码示例展示如何使用 `set -u` 和 readonly 变量进行更精确的错误处理,利用 `nameref` 实现引用变量,以及使用数组切片进行批处理。Readline 方面的改进包括增强的补全和搜索控制,可通过 `.inputrc` 或 `bind` 命令配置。安全方面涉及环境变量继承处理和命令注入防护。性能优化包括大型数组的快速操作和缩减的内存占用。技能还提供了版本检测脚本、迁移提示以及指向官方 Bash NEWS 文件和 Readline 文档的参考链接,帮助开发者从 Bash 5.1 平稳升级并利用新特性。

兼容平台✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/Jamie-BitFlight/claude_skills/tree/main/plugins/bash-development/skills/bash-52-features

Installed? Explore more 编程与开发 skills: steipete/bluebubbles, steipete/eightctl, steipete/blucli · View all 6 →

在你喜欢的 AI 中提问

打开一个已预加载此 Agent Skill 的新对话。

文档

Bash 5.2 功能与改进

Bash 5.2 于 2022 年 9 月发布,带来了变量处理、readline 集成、数组支持方面的增强以及大量错误修复。

变量处理增强

改进的只读和未设置变量行为

更清晰的错误信息和更一致的行为:

# 针对只读变量更详细的错误信息
readonly CONFIG_PATH="/etc/app/config"

# 尝试修改会生成更清晰的错误
CONFIG_PATH="/tmp/config"  # bash: CONFIG_PATH: readonly variable

# 使用 set -u 时更好地处理未设置变量
set -u

# 现在使用前检查更加可靠
if [[ -n "${OPTIONAL_VAR:-}" ]]; then
    echo "变量已设置: ${OPTIONAL_VAR}"
else
    echo "变量未设置"
fi

# 实用示例:配置验证
validate_config() {
    local -a required_vars=("DATABASE_URL" "API_KEY" "LOG_DIR")
    local var

    for var in "${required_vars[@]}"; do
        if [[ -z "${!var:-}" ]]; then
            printf '错误:必需变量 %s 未设置\n' "${var}" >&2
            return 1
        fi
    done

    echo "所有必需的配置变量均已设置"
}

export DATABASE_URL="postgres://localhost/db"
export API_KEY="secret123"
export LOG_DIR="/var/log/app"

validate_config

Nameref 改进

增强的引用变量处理。

代码示例

Readline 8.2 集成

命令行编辑的显著改进:

增强的补全和历史功能

# 在 ~/.inputrc 中更好的补全行为
# 跳过不可见字符的补全
set skip-completed-text on

# 增强的历史搜索
# 通过前缀匹配循环浏览历史
bind '"\e[A": history-search-backward'  # 上箭头
bind '"\e[B": history-search-forward'   # 下箭头

# 改进的补全着色
set colored-stats on
set colored-completion-prefix on

# 更好的长补全处理
set completion-display-width 0  # 使用终端全宽

输入处理改进

代码示例

数组支持增强

更好的索引数组操作

# 改进的数组切片和扩展
array=(10 20 30 40 50 60 70 80 90)

# 切片符号更加可靠
echo "前3个: ${array[@]:0:3}"      # 10 20 30
echo "后3个: ${array[@]: -3}"       # 70 80 90
echo "中间: ${array[@]:3:3}"       # 40 50 60

# 实用示例:批处理
process_batch() {
    local -a items=("$@")
    local batch_size=3
    local i

    for ((i = 0; i < ${#items[@]}; i += batch_size)); do
        local -a batch=("${items[@]:i:batch_size}")
        printf '处理批次 %d: %s\n' \
            "$((i / batch_size + 1))" \
            "${batch[*]}"

        # 处理批次中的项目...
        for item in "${batch[@]}"; do
            echo "  处理中: ${item}"
        done
    done
}

files=(file1 file2 file3 file4 file5 file6 file7)
process_batch "${files[@]}"

关联数组改进

代码示例

参数扩展增强

改进的模式匹配

代码示例

增强的子字符串操作

代码示例

安全修复

Bash 5.2 包含多项安全相关修复:

  • 改进了环境变量继承的处理
  • 更好的变量名验证
  • 增强了特定上下文中防止命令注入的保护

代码示例

性能改进

  • 复杂场景下的变量扩展更快速
  • 针对大型数组优化的数组操作
  • 关联数组减少内存占用
  • 模式匹配效率提升
# 展示性能提升的基准测试示例
benchmark_arrays() {
    local -a array
    local i
    local start end

    start="${EPOCHREALTIME}"

    # 大型数组操作在 5.2 中更快
    for ((i = 0; i < 10000; i++)); do
        array+=("item_${i}")
    done

    end="${EPOCHREALTIME}"

    printf '数组填充时间: %.4f 秒\n' \
        "$(awk "BEGIN {print ${end} - ${start}}")"

    echo "数组大小: ${#array[@]}"
}

benchmark_arrays

兼容性说明

从 Bash 5.1 升级

总体向后兼容,但需注意:

  • 变量扩展的某些边界情况行为已改变
  • 错误消息更详细(可能影响解析 stderr 的脚本)
  • Readline 行为变化可能影响交互式脚本

版本检查

# 检查 Bash 5.2 功能
if [[ "${BASH_VERSINFO[0]}" -eq 5 ]] && [[ "${BASH_VERSINFO[1]}" -ge 2 ]]; then
    echo "Bash 5.2+ 功能可用"
    # 使用增强功能
elif [[ "${BASH_VERSINFO[0]}" -ge 6 ]]; then
    echo "检测到 Bash 6.0+"
else
    echo "Bash 版本过旧,不支持 5.2 功能"
fi

迁移提示

从 Bash 5.1 迁移到 5.2

大多数脚本无需修改即可运行,但需考虑:

代码示例

参考

附加资源

有关更广泛的 Bash 开发模式和最佳实践,请参阅:

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

Jamie-BitFlight/agentskill-kaizen-meta-docs

Agentskill kaizen plugin documentation index. Load when needing to read about cross-platform notes, improvement plans, or DuckDB integration.

Jamie-BitFlight/bash-51-features

Bash 5.1 release features and improvements with practical examples. Use when working with Bash 5.1 features, epoch time variables, redirection enhancements, or when user asks about Bash 5.1 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-53-features

Bash 5.3 release features and improvements with practical examples. Use when working with Bash 5.3 features, new command substitution, GLOBSORT, loadable builtins, or when user asks about Bash 5.3 changes, new features, or version-specific capabilities.

Jamie-BitFlight/bash-development

This skill should be used when the user asks to "write a bash script", "create a shell script", "implement bash function", "parse arguments in bash", "handle errors in bash", or mentions bash development, shell scripting, script templates, or modern bash patterns.

Jamie-BitFlight/bash-lint

This skill should be used when the user asks to "lint bash script", "run shellcheck", "format shell script", "use shfmt", "fix shellcheck errors", or mentions shell script linting, formatting, code quality, or pre-commit hooks for bash.

Jamie-BitFlight/bash-logging

This skill should be used when the user asks to "add logging to bash script", "colorize output", "implement log levels", "CI/CD sections", "terminal colors in bash", or mentions logging functions, emoji output, collapsible CI sections, or shlocksmith.

Jamie-BitFlight/bash-portability

This skill should be used when the user asks about "POSIX compatibility", "portable shell scripts", "cross-shell compatibility", "bashisms", "shebang selection", or mentions writing scripts that work on different shells (bash, sh, dash, zsh) or different systems.

Jamie-BitFlight/bash-testing

This skill should be used when the user asks to "test bash script", "write shell tests", "use shunit2", "use shellspec", "create test suite for bash", or mentions unit testing, test frameworks, mocking, or test-driven development for shell scripts.

Jamie-BitFlight/brainstorming-skill

You MUST use this before any creative work - creating features, building components, adding functionality, modifying behavior, or when users request help with ideation, marketing, and strategic planning. Explores user intent, requirements, and design before implementation using research-validated prompt patterns.

Jamie-BitFlight/clang-format

Configure clang-format code formatting. Use when: user mentions clang-format or .clang-format, analyzing code style/patterns, creating/modifying formatting config, troubleshooting formatting, brace styles/indentation/spacing/alignment/pointer alignment, or codifying conventions.

Jamie-BitFlight/commitlint

When setting up commit message validation for a project. When project has commitlint.config.js or .commitlintrc files. When configuring CI/CD to enforce commit format. When extracting commit rules for LLM prompt generation. When debugging commit message rejection errors.

Jamie-BitFlight/conventional-commits

When writing a git commit message. When task completes and changes need committing. When project uses semantic-release, commitizen, git-cliff. When choosing between feat/fix/chore/docs types. When indicating breaking changes. When generating changelogs from commit history.

Jamie-BitFlight/dasel-reference

Use when querying, modifying, or converting JSON, YAML, TOML, XML, CSV, HCL, or INI with dasel v3. Complete reference for selectors, functions, conditionals, variables, spread operator, type casting, and format-specific patterns.

Jamie-BitFlight/data-exploration

Use when exploring unknown structured data files with dasel v3 — discover schema, list keys, find nested values, sample arrays, identify data types across JSON, YAML, TOML, XML, CSV, HCL, INI formats

Jamie-BitFlight/data-transformation

Use when modifying, converting, or transforming structured data with dasel v3 — in-place mutations, format conversion, batch operations, array manipulation, object construction, and merge patterns across JSON, YAML, TOML, XML, CSV, HCL, INI

Jamie-BitFlight/delegate

Decompose substantive work into phases, dispatch each phase to a sub-agent, and adjudicate what comes back. Use whenever a request asks for implementation, investigation, a fix, a review, or any change to files — including small ones — and whenever you are about to read source or run a diagnostic yourself instead of handing it off. Also use when a report from a sub-agent needs judging, when a phase needs re-dispatching, or when a user names one instance of a pattern. Does not apply when your own prompt begins "Your ROLE_TYPE is sub-agent." — then follow references/sub-agent-contract.md instead.

Jamie-BitFlight/enterprise-hibernate-hbm

Dasel v3 query patterns for Hibernate .hbm.xml mapping files — entity-table binding, Java property-to-column extraction, one-to-many set/list/bag relationship tracing, many-to-one foreign key discovery, batch scanning across 60+ HBM files. Use when querying Hibernate ORM class mappings, extracting schema metadata from Java persistence layer, or auditing entity-column relationships in enterprise legacy codebases.

Jamie-BitFlight/enterprise-installanywhere

Dasel v3 query patterns for InstallAnywhere .iap_xml installer definitions — use when querying action sequences, discovering variables, resolving platform conditions, navigating panels, or comparing installer variants. Files are 2.5+ MB, 65,000+ lines — too large for context reads, requires structural dasel queries.

Jamie-BitFlight/enterprise-maven-pom

Dasel v3 selector patterns for Maven POM XML files — use when querying dependency versions, filtering by groupId or scope, extracting module hierarchy from parent POMs, or detecting version conflicts across enterprise multi-module Java projects. Load this skill when working with pom.xml files using dasel.

Jamie-BitFlight/enterprise-spring-xml

Dasel v3 selectors for Spring bean factory XML — use when querying any Spring ApplicationContext XML for bean discovery, dependency wiring, JMS destination mapping, property injection extraction, or cross-bean reference tracing. Load this skill before writing dasel selectors against Spring bean XML files (applicationContext.xml, *_beans.xml, spring-*.xml).

相关技能