launchd 服务环境变量与 Shell 环境变量的独立性解析

## **launchd 服务环境变量与 Shell 环境变量的独立性解析**
在 macOS 的 `launchd` 服务中，服务进程的 **运行时环境变量与用户 Shell 环境变量是相互隔离的**，这一点与 Linux 的 `systemd` 服务管理类似。以下是详细分析：

---

### **1. launchd 服务环境变量的配置原则**
- **独立性**：`launchd` 服务通过 `.plist` 文件中的 `<key>EnvironmentVariables</key>` 显式定义环境变量，这些变量**仅作用于服务进程**，与用户终端（如 `.bash_ollama`、`.zshrc`）中的环境变量无关。
- **优先级**：若在 `.plist` 文件和 Shell 配置文件中定义了同名变量，服务进程会优先使用 `.plist` 中的值，而非用户环境变量。

---

### **2. 为何不应从 `.bash_ollama` 提取变量？**
- **作用域不同**：
  - `.bash_ollama` 是用户 Shell 的配置文件，仅对当前用户的终端会话生效。
  - `launchd` 服务运行于系统级上下文（即使配置在用户级 `LaunchAgents` 目录），其环境需通过 `.plist` 独立定义。
- **加载时机差异**：
  - Shell 变量在用户登录后加载，而 `launchd` 服务可能在系统启动或用户未登录时启动，此时 `.bash_ollama` 未被加载。
- **变量继承限制**：
  - `launchd` 服务进程不会继承用户 Shell 的环境变量，必须通过 `.plist` 显式设置。

---

### **3. 正确配置 launchd 服务变量的方法**
在 `com.ollama.plist` 中直接定义所有必要的环境变量：
```xml
<key>EnvironmentVariables</key>
<dict>
    <key>OLLAMA_HOST</key>
    <string>0.0.0.0:11434</string>
    <key>OLLAMA_MAX_VRAM</key>
    <string>8192</string>
    
</dict>
```
- **优势**：确保服务启动时变量已明确加载，避免依赖外部配置的不可控性。

---

### **4. 常见误区与解决方案**
- **误区**：通过 Shell 脚本在 `.plist` 中动态加载 `.bash_ollama`。
- **风险**：
  - 若 `ProgramArguments` 中调用 `source ~/.bash_ollama`，会导致变量仅在脚本执行时生效，无法传递到主服务进程。
- **正确做法**：将变量逐一定义在 `.plist` 的 `EnvironmentVariables` 块中。

---

### **5. 调试与验证**
- **查看服务环境变量**：
  ```bash
  launchctl getenv OLLAMA_HOST  # 仅对已加载的服务生效
  ```
- **日志验证**：在服务日志中检查实际生效的变量值：
  ```bash
  tail -f /var/log/ollama.log | grep "OLLAMA_HOST"
  ```

---

## **总结**
- **核心原则**：`launchd` 服务环境变量需通过 `.plist` 文件独立配置，与用户 Shell 环境变量完全隔离。
- **最佳实践**：避免从 `.bash_ollama` 或其他 Shell 配置中提取变量，直接显式定义所有服务所需变量。
- **扩展参考**：类似问题在 Linux `systemd` 中通过 `EnvironmentFile` 或 `Environment` 指令处理，但 macOS 的 `launchd` 需严格遵循其 XML 配置语法。