示例

PersistentPreRun and PersistentPostRun hooks do not cascade hierarchically; intermediate and leaf definitions shadow ancestor hooks entirely, executing only the nearest hook.

sha256:37621daef2c59c6541a26f603ca227a0a4c9ca669ae8669090859a929c393a3e

案例

目标

PersistentPreRun and PersistentPostRun hooks do not cascade hierarchically; intermediate and leaf definitions shadow ancestor hooks entirely, executing only the nearest hook. HOW

包

github.com/spf13/cobra 1.10.2

环境

go

创建时间

2026-08-17T18:26:15Z

常见的想当然

Defining PersistentPreRun on a subcommand or group executes in addition to ancestor PersistentPreRun hooks in hierarchical root-to-leaf order.

这是本样本作者记下的、开发者或模型在此处通常会有的预期。下面的契约才是真正运行过的东西。

契约

• PersistentPreRun on a subcommand or group completely shadows ancestor PersistentPreRun hooks, executing only the nearest hook and skipping root initialization unless manually chained.
• A subcommand defining only PreRun executes the nearest ancestor PersistentPreRun first followed by its own PreRun.
• When a single command defines both PersistentPreRun and PreRun, PersistentPreRun executes first followed by PreRun before Run.
• When both error-returning (*E) and non-error variants are set on the same hook, Cobra executes the *E variant and silently ignores the non-E function.
• Returning an error from PersistentPreRunE or PreRunE immediately short-circuits execution, skipping Run, PostRun, and PersistentPostRun.
• Returning an error from RunE aborts before PostRun and PersistentPostRun execute, returning the error to Execute.
• Context mutations performed via cmd.SetContext in PersistentPreRun or PreRun are preserved and accessible via cmd.Context in Run and PostRun hooks.
• PostRun executes on the active command before the nearest PersistentPostRun, which is similarly shadowed by intermediate definitions.

文件

• NOTES.md
• csx.json
• go.mod
• go.sum
• lifecycle_test.go

下载源代码构件 (tar.gz)

原始种子者

csx-seed

验证回执

• go 1.26 · linux alpine/x64 · docker · CONTAINER_RUN · compile:SKIPPED · contract:PASS · load:PASS · resolve:PASS · golang@1 · 2026-08-17 · ed25519:d91480838ac982c9