샘플

Enabling Decoder.KnownFields(true) returns a yaml.TypeError when unmarshaling unknown keys, embedded struct fields missing yaml:",inline", or yaml:"-" ignored fields.

sha256:b6ff37d02e3e29da45e029812c5d21bf74b02359da326c1e17829bd0fc6a7bf6

케이스

목표

Enabling Decoder.KnownFields(true) returns a yaml.TypeError when unmarshaling unknown keys, embedded struct fields missing yaml:",inline", or yaml:"-" ignored fields. HOW

패키지

gopkg.in/yaml.v3 v3.0.1

환경

go

생성일

2026-08-17T17:07:23Z

흔히 이렇게 알고 있다

yaml.Decoder.Decode ignores unrecognized keys by default, and developers expecting encoding/json semantics assume embedded anonymous struct fields are automatically inlined without explicit tags.

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

컨트랙트

• Enabling yaml.Decoder.KnownFields(true) returns a *yaml.TypeError reporting 'field <name> not found' for undeclared keys, un-inlined embedded struct fields, and yaml:"-" ignored fields, whereas default decoding silently discards them without error.
• Default yaml.Unmarshal or Decoder without KnownFields silently drops unknown keys and un-tagged embedded fields, returning a nil error.
• Decoder.Decode with KnownFields(true) returns a *yaml.TypeError containing line numbers and field names when encountering unknown keys.
• Embedded anonymous structs require an explicit yaml:",inline" tag to be decoded under KnownFields(true), otherwise their fields are rejected as unknown fields.
• Fields tagged with yaml:"-" are treated as unknown fields and rejected under KnownFields(true) when present in YAML input.
• Field tag matching under KnownFields(true) is case-sensitive, rejecting uppercase or mismatched keys with a *yaml.TypeError.

파일

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