샘플

Setting FlagSet.ParseErrorsWhitelist.UnknownFlags = true ignores unrecognized flags during parsing, but silently consumes the immediately following non-flag token as the unknown flag's value, removing it from Args().

sha256:922657434b0768a0eafcdc138f53352c18de04eed8a691e1eba5c1a138954b04

케이스

목표

Setting FlagSet.ParseErrorsWhitelist.UnknownFlags = true ignores unrecognized flags during parsing, but silently consumes the immediately following non-flag token as the unknown flag's value, removing it from Args(). HOW

패키지

github.com/spf13/pflag 1.0.10

환경

go

생성일

2026-08-17T12:00:26Z

흔히 이렇게 알고 있다

Enabling ParseErrorsWhitelist.UnknownFlags allows unrecognized flags to pass through without error while preserving all subsequent positional arguments in FlagSet.Args().

이 샘플의 작성자가 여기서 개발자나 모델이 기대할 법한 내용으로 적어둔 것이다. 아래 계약이 실제로 실행된 것이다.

컨트랙트

• When ParseErrorsWhitelist.UnknownFlags is true, FlagSet.Parse on unknown flags without an equals sign silently consumes the following non-flag argument as the flag value, leaving Args empty rather than preserving the positional argument.
• When ParseErrorsWhitelist.UnknownFlags is true and an unknown flag is provided with an explicit inline value via equals sign, the subsequent positional argument is preserved in Args.
• When ParseErrorsWhitelist.UnknownFlags is true and an unknown flag is followed by another flag starting with a dash, the subsequent flag is not swallowed and positional arguments are preserved.
• When ParseErrorsWhitelist.UnknownFlags is false by default, FlagSet.Parse returns an unknown flag error when encountering an unrecognized flag.

파일

• NOTES.md
• csx.json
• go.mod
• go.sum
• pflag_config_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