普贤教程 › 包参考

dotenv 包

.env 配置解析

项	值
包名	`dotenv`
版本	`0.2.0`
可用版本	`0.1.0 / 0.2.0`
入口	`dotenv.px`
分类	`数据格式与编解码`
文件数 / 行数	`1 / 293`

安装与引入

bash

pxpkg init          # 首次
pxpkg add dotenv@0.2.0
pxpkg install

import dotenv

所属分类教程：数据格式与编解码

公开接口

函数	参数
`dotenv_parse`	`s`
`dotenv_load`	`path`

其余 16 个 def（内部与辅助，可直接调用但不属稳定接口）

函数	参数
`de_is_key_char`	`c`
`de_parse_line`	`line`
`de_strip_inline_comment`	`v`
`de_unquote_single`	`v`
`de_unquote_double`	`v`
`dotenv_dump`	`d`
`dotenv_merge`	`a, b`
`dotenv_expand`	`d`
`de_expand_value`	`d, self_key, val, depth`
`dotenv_get`	`d, key, default = ""`
`dotenv_get_required`	`d, key`
`dotenv_get_int`	`d, key, default = 0`
`dotenv_get_bool`	`d, key, default = false`
`dotenv_validate`	`d, required_keys`
`dotenv_to_shell`	`d`
`dotenv_save`	`path, d`

包内说明（源码头注释）

text

============================================================
普贤生态库：registry/dotenv —— .env 配置解析
------------------------------------------------------------
纯函数库（无 IO 于 dotenv_parse；dotenv_load 读文件），编译与解释双模式一致。
dotenv_parse(s) → dict       纯解析，永不失败；非法行跳过
dotenv_load(path) → Ok(dict) | Err   读文件 + 解析
支持：
KEY=value / KEY = "quoted" / 'single' / export KEY=value
# 注释行；行内注释（未加引号的值中 " #" 起截断）
"..." 内转义 \n \t \r \\ \"
规则：
- 值一律为字符串（对齐 python-dotenv）
- key 限 [A-Za-z0-9_]，不以数字开头；非法 key 的行跳过
- 未闭合双引号：余下全作字面量（宽松）
说明：不提供 setenv/覆盖系统环境（native 无 setenv 语义），
由调用方决定合并策略（如 env 优先 → .env 兜底）。
============================================================