把 kebab-case 名称转换为 SCREAMING_SNAKE_CASE:listen-port → LISTEN_PORT,max-body-size → MAX_BODY_SIZE。这正是从 CLI 参数或 YAML key 到覆盖它的环境变量的那一步,那些同时接受 --log-format 和 LOG_FORMAT 的工具背后就是这个规律。
粘贴配置文件的 key 或 --help 输出中的参数,就能得到 .env 文件、Dockerfile 和 CI 设置所需的变量名。
--help 的片段粘贴到 文本字符串 中。MYAPP_)。listen-port: 8080
log-format: json
max-body-size: 1mbLISTEN_PORT: 8080
LOG_FORMAT: json
MAX_BODY_SIZE: 1mb每个 YAML key 都变成了大写的环境变量名;json、1mb 这样的值不是 kebab-case,因此保留原样。
log-format → LOG_FORMAT,retry-2-times → RETRY_2_TIMES。--,都留在原处。如果 Go 或 Rust 的 CLI 把参数绑定到环境变量(viper 或 clap 的 env 特性可以做到),转换参数列表就能得到要写进文档的变量名。
服务从 config.yaml 读取 listen-port,同时也允许用环境变量覆盖时,转换后的名称就是要写进 docker-compose.yml 或 CI secret 设置的内容。
--,短横线会保留:--log-level → --LOG_LEVEL。请粘贴不带前缀的名称。x-1 这样的短表达式看起来也像 kebab-case,会变成 X_1,所以不要在输入中放算式。APP_ 之类的前缀吗?不会。之后在编辑器里加上,或者直接在输入里写成 app-listen-port。
http2-enabled 这样的 key 呢?会干净地转换成 HTTP2_ENABLED,因为数字属于第一个片段。