SwiftDotenv无法加载密钥：默认读取.env文件失败报错咨询

开发者阿泽

2026-6-19

SwiftDotenv 无法读取.env文件的解决方案

问题核心原因

代码找不到.env文件的本质是运行时文件路径与预期不一致：SwiftDotenv默认的configure()会在当前工作目录查找.env，但iOS/macOS App的运行工作目录并非项目根目录；直接写相对路径也无效，因为App打包后文件会被放入bundle中，必须通过Bundle获取正确路径。

解决步骤

1. 确保.env文件已添加到项目目标

选中Xcode项目导航栏里的.env（或development.env）文件，右侧「File Inspector」中，确认「Target Membership」下你的App目标已被勾选；
也可进入项目设置的「Build Phases」→「Copy Bundle Resources」，检查目标文件是否在列表中，未添加则直接将文件拖入列表。

2. 使用Bundle获取正确文件路径

不要直接写相对路径，改用Bundle获取文件绝对路径，修改代码如下：

@main
struct LearnApp: App {
    
    init() {
        do {
            // 若使用默认.env文件，替换为 guard let envFilePath = Bundle.main.path(forResource: ".env", ofType: nil)
            guard let envFilePath = Bundle.main.path(forResource: "development", ofType: "env") else {
                throw Dotenv.LoadingFailure.environmentFileIsMissing
            }
            try Dotenv.configure(atPath: envFilePath, overwrite: false)
        } catch {
            print("加载环境变量失败：\(error.localizedDescription)")
            // 可根据需求添加错误处理逻辑，比如弹窗提示用户
        }
    }
    
    var body: some Scene {
        WindowGroup {
            NavigationStack {
                Text("View")
            }
        }
    }
}