游乐游手机版
首页/AI热点日报/热点详情

DeepSeek API环境变量配置方法从入门到精通完全指南

类型:热点整理2026-08-06
设置DeepSeekAPI环境变量可避免硬编码密钥泄露风险。推荐在项目根目录创建 env文件写入密钥,配合PyCharm插件自动加载。Windows可通过系统环境变量或PowerShell临时设置,Linux macOS需编辑shell配置文件并执行source命令生效。

在调用DeepSeek API时,密钥的安全保管是每位开发者必须重视的环节——若将密钥硬编码在代码中,一旦不慎上传至GitHub,便等于将账号权限拱手让与他人。正确的做法,是将密钥存入环境变量。以下这份实操指南,将帮助你彻底掌握这一关键技能,确保DeepSeek API密钥安全无忧。

利用 .env 文件自动加载(PyCharm 推荐方案)

第一步:在项目根目录下新建一个纯文本文件,命名为 【.env】(注意是英文点号开头,不可命名为 env.txt 或 .env.txt)。

第二步:使用记事本或 VS Code 打开该 .env 文件,在其中写入一行内容:
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

第三步:安装 PyCharm 插件 “Env File”,重启 IDE 后,右键点击项目根目录 → 选择 “Load Env File” → 找到并选中你刚创建的 .env 文件。

此操作非常简便,直接将文件拖入即可。PyCharm 会自动解析并注入所有环境变量,后续运行脚本时,os.getenv("DEEPSEEK_API_KEY") 便能正确读取密钥值,有效避免环境变量配置错误。

手动设置系统级环境变量(Windows 系统)

方法一:图形界面精细化设置
① 右键“此电脑”→“属性”→左侧“高级系统设置”→在弹出的窗口中点击“环境变量”
② 在“系统变量”区域点击“新建”→变量名填写 【DEEPSEEK_API_KEY】(字母大小写必须完全一致)→变量值粘贴你的 DeepSeek API 密钥
③ 点击“确定”保存,然后务必彻底关闭并重新打开所有已开启的终端、命令行窗口以及 PyCharm——否则环境变量不会立即生效,可能导致调用失败。

方法二:PowerShell 临时设置(仅对当前会话有效)
打开 PowerShell,执行以下命令:
$env:DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

注意:此方法退出终端后即失效,仅适合临时调试或快速测试,不可用于正式生产环境。

Linux/macOS 终端配置指南

编辑 shell 配置文件:
若使用 bash,运行 nano ~/.bashrc;若使用 zsh,运行 nano ~/.zshrc。

在文件末尾添加如下一行:
export DEEPSEEK_API_KEY="sk-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"

保存后执行 source ~/.bashrc(或 source ~/.zshrc)即可立即生效,无需重启终端。

【关键提醒】配置文件中切勿添加多余空格,例如 export DEEPSEEK_API_KEY = "xxx" 是错误的写法——等号前后不能有空格,否则环境变量将无法被正确识别,导致密钥缺失。

来源:https://www.php.cn/faq/2936634.html?uid=1431639

相关热点

继续查看同栏目近期热点。

延伸阅读

补充最近整理过的热点入口。