Debian 环境下为 os-copilot 配置环境变量
在 Debian 上，os-copilot 本质是一个命令行工具，系统并不会自动为其设置专属变量。通常的做法是把需要的变量配置到当前用户的 Shell 启动文件（如 ~/.bashrc）或系统级配置中，使 copilot 子进程能够继承这些变量。若你通过脚本安装，安装说明里也常建议“修改 .bashrc 以持久化设置环境变量”。
常用配置方式
-
临时生效（当前终端会话）
- 直接在终端导出变量，例如：
- export API_KEY=sk-xxxxxx
- export MY_REGION=cn-hangzhou
- 仅对当前会话有效，关闭终端后失效。
-
用户级持久化（推荐）
- 编辑当前用户的 ~/.bashrc：
- nano ~/.bashrc
- 在文件末尾添加：export API_KEY=sk-xxxxxx
- 使配置立即生效：source ~/.bashrc
- 如需图形/登录会话也生效，可同时写入 ~/.profile。
-
系统级持久化（所有用户）
- 编辑 /etc/environment（键值对，不使用 export）：
- sudo nano /etc/environment
- 例如：API_KEY=sk-xxxxxx
- 生效方式：重新登录或重启系统
- 或在 /etc/profile.d/ 下创建脚本（使用 export）：
- sudo nano /etc/profile.d/copilot.sh
- 例如：export API_KEY=sk-xxxxxx
- 赋权：sudo chmod +x /etc/profile.d/copilot.sh。
-
服务或守护进程场景
- 若以 systemd 管理相关服务，在单元文件 [Service] 段设置：
- Environment=API_KEY=sk-xxxxxx
- 然后：sudo systemctl daemon-reload && sudo systemctl restart your-service。
与 os-copilot 的配合与验证
-
选择放置位置
- 仅当前用户使用：写入 ~/.bashrc（或 ~/.profile）。
- 所有用户使用：写入 /etc/environment 或 /etc/profile.d/。
- 若不确定，优先放在 ~/.bashrc，便于维护与回滚。
-
使配置生效
- 用户级：执行 source ~/.bashrc（或重新登录）。
- 系统级：重新登录或重启（/etc/environment 场景）。
-
验证变量是否生效
- 查看变量：echo $API_KEY
- 查看所有变量：printenv
- 检查 copilot 进程的环境（示例）：pgrep -x copilot | xargs -I{} tr ‘\0’ ‘\n’ < /proc/{}/environ | grep -E ‘^(API_KEY|MY_VAR)=’
- 若变量包含空格或特殊字符，务必加引号：export API_KEY=“sk- with space”。
常见问题与排查