shdotenv: 环境变量加载工具，适用于多种Shell

shdotenv: 环境变量加载工具，适用于多种Shell

shdotenvdotenv for shells with support for POSIX-compliant and multiple .env file syntax项目地址:https://gitcode.com/gh_mirrors/sh/shdotenv

项目介绍

shdotenv 是一个专为贝壳环境设计的 dotenv 实现，它支持POSIX兼容的环境文件语法，并且可以处理多种env文件语法风格以促进互操作性。这个单文件脚本结合了嵌入式的 awk 脚本，确保其在几乎任何环境中都能运行，无论是在 dash、bash、ksh、zsh 还是其他符合POSIX标准的Shell下。shdotenv简化了从脚本中安全加载环境变量的过程，尤其适合那些需要处理敏感配置或跨平台项目的开发者。

项目快速启动

要迅速开始使用 shdotenv，请遵循以下步骤：

安装

首先，你需要将 shdotenv 下载到你的可执行路径中：

mkdir -p "$HOME/local/bin"
wget https://github.com/ko1nksm/shdotenv/releases/latest/download/shdotenv -O "$HOME/local/bin/shdotenv"
chmod +x "$HOME/local/bin/shdotenv"

记得将安装目录添加到PATH环境变量中，以便全局访问。

基本使用

安装完成后，你可以通过 shdotenv 加载环境变量并执行命令。例如，如果你有一个 .env 文件，可以这样做：

shdotenv run your-command-here

如果只想导出环境变量而不立即执行命令，可以这样做：

shdotenv export > envvars.sh
source envvars.sh

应用案例和最佳实践

Docker环境中的使用

在Docker中，有时需要传递复杂的环境变量，包括多行文本。shdotenv 提供了解决方案：

docker run $(shdotenv -n | sed 's/^/-e /') debian sh -c 'your command here'

这样，Docker可以从包含多行值的.env文件中读取环境变量。

环境文件规范

环境文件应遵循简单的键值对规则，支持注释和特定的语法来处理特殊字符和多行字符串。示例：

COMMENT=这是注释
UNQUOTED=value1
SINGLE_QUOTED='value 2'
DOUBLE_QUOTED="value 3 with \"escaped\" quotes"
MULTILINE="line1\nline2: \ actual newline \nline3"

典型生态项目

尽管 shdotenv 主要作为独立工具存在，但它在集成各种Shell脚本或自动化工作流程中扮演关键角色。例如，在持续集成（CI）脚本中管理环境变量，或者在微服务架构中为每个服务独立配置环境。虽然该项目本身不直接与其他生态项目绑定，但它的通用性和对多种Shell的支持使其成为与GitOps工具、CI/CD框架等工具配套使用的理想选择。

通过将其融入开发和部署流程中，shdotenv 可以帮助团队统一管理环境配置，提高配置的一致性和安全性，尤其是对于多环境部署场景（如开发、测试、生产）而言，其重要性不言而喻。

---

以上就是关于 shdotenv 的简明教程，希望对你开始使用这个强大的环境变量管理工具有所帮助。

shdotenvdotenv for shells with support for POSIX-compliant and multiple .env file syntax项目地址:https://gitcode.com/gh_mirrors/sh/shdotenv