GitHub Actions构建的NPM CLI二进制无法读取环境变量求助

1. 确认.env是否被打包进NPM包 #

• 检查package.json的files字段是否包含.env，同时确保.npmignore里没有排除这个文件。如果打包时没把.env包含进去，安装后自然找不到文件。
• 本地执行npm pack，解压生成的.tgz包，直接查看里面是否存在.env文件，验证打包逻辑是否正确。

2. 排查二进制运行时的工作目录问题 #

• Rust的dotenv默认从当前工作目录加载.env，而非二进制文件所在目录。用户安装后运行二进制时，工作目录可能不是包的安装目录，导致找不到文件。
• 解决方案：在代码中指定.env的绝对路径。比如通过std::env::current_exe()获取二进制路径，推导.env的位置：

use dotenv;
use std::path::PathBuf;

fn load_env() {
    let exe_path = std::env::current_exe().expect("Failed to get exe path");
    let env_path = exe_path.parent().unwrap().join(".env");
    dotenv::from_path(env_path).ok();
}

3. 区分编译时硬编码与运行时读取 #

• 如果你是想在运行时读取.env，要确保代码没在编译阶段把环境变量硬编码。比如env!()宏会在编译时替换值，运行时不会再读取.env。
• 确认代码中用的是dotenv::var()或std::env::var()（需在dotenv::load()之后调用）来获取运行时环境变量。

4. 验证GitHub Actions打包时的.env内容 #

• 在Workflow的打包步骤前添加cat .env命令，输出文件内容，确认里面的键值对正确。避免出现构建时环境变量存在，但.env文件未正确生成或复制到构建目录的情况。

5. 检查NPM包的二进制执行脚本 #

• 如果package.json的bin字段指定了执行脚本，确认脚本是否正确处理工作目录。比如脚本是否直接调用二进制，或者是否先切换到包含.env的目录再执行：

{
  "bin": {
    "your-cli": "./bin/your-cli"
  }
}

确保脚本所在目录下存在.env，或脚本内有切换目录的逻辑。

内容的提问来源于stack exchange，提问作者Seto