第 3 章:环境变量和 PATH
本章目标:弄懂环境变量为什么「关掉终端就没了」,把 API Key 长期保存下来;看懂
command not found,知道 PATH 是怎么找命令的。
开篇:昨天还好好的
《大模型 API 调用》第 1 章教你这样设 Key:
export DEEPSEEK_API_KEY="sk-你的Key"当时跑通了。第二天打开终端再运行,报错 KeyError: 'DEEPSEEK_API_KEY'。Key 去哪了?
还有一种:教程里写 python weekly.py,你一敲,终端说 command not found: python。可你明明装过 Python。
两个问题,答案都在「环境」这两个字上。
学完这一章,你能:
- 说清环境变量是什么、为什么只在当前窗口有效
- 在 macOS 和 Windows 上把 Key 长期保存
- 看懂 PATH,知道
command not found该怎么查
3.1 环境变量是什么
终端里有一张小纸条,上面写着一些「名字 = 值」,比如 DEEPSEEK_API_KEY = sk-...。你在这个终端里运行的程序,都能看到这张纸条。这就是环境变量。
Python 里那句 os.environ["DEEPSEEK_API_KEY"],就是去纸条上找这个名字。找不到,就是 KeyError。
用 echo 可以看纸条上某个名字的值:
echo $DEEPSEEK_API_KEYecho $env:DEEPSEEK_API_KEY有值就会打出来(注意别在别人面前、别在截图里这么做),没有就是一个空行。
3.2 为什么关掉就没了
export(Windows 上是 $env:名字="值")只是在当前这个窗口的纸条上写了一行。新开的窗口有一张新的纸条,上面没有。
我用两个终端实际试了一下(为了不暴露真 Key,用了一个演示变量):
窗口 A:
% export DEMO_KEY="abc"
% echo "[$DEMO_KEY]"
[abc]
窗口 B(新开的):
% echo "[$DEMO_KEY]"
[]窗口 A 里有,新开的窗口 B 里是空的。关掉窗口 A,它那张纸条也就没了。
3.3 长期保存:写进配置文件
要让每个新窗口都自动带上这个变量,就得把它写进一个每次打开终端都会读的地方。
# macOS 默认的终端(zsh)每次启动都会读 ~/.zshrc
echo 'export DEEPSEEK_API_KEY="sk-你的Key"' >> ~/.zshrc
# 让当前窗口也立刻生效(新窗口会自动读)
source ~/.zshrc
# 检查
echo $DEEPSEEK_API_KEY# 写进当前用户的环境变量(永久保存)
setx DEEPSEEK_API_KEY "sk-你的Key"
# setx 只对「之后新开的窗口」生效:关掉这个窗口,重新打开 PowerShell
# 检查
echo $env:DEEPSEEK_API_KEY几个要点:
- macOS 那行用的是
>>(追加到文件末尾)。千万别写成>,一个>会把整个~/.zshrc清空再写,你原来的配置就没了 - Windows 的
setx设完,当前窗口还是看不到,一定要新开一个 - Windows 也可以用图形界面:开始菜单搜「编辑账户的环境变量」,在「用户变量」里新建,名字
DEEPSEEK_API_KEY,值填 Key
别用 setx 改 PATH
网上有教程教你用 setx PATH "%PATH%;新路径" 往 PATH 里加东西。别这么做:setx 会把超过 1024 个字符的值截断,PATH 一长就被截坏了,很多命令会突然找不到。改 PATH 请用上面说的图形界面。
Key 存在哪更安全
写进 ~/.zshrc 或用户环境变量,Key 是以明文存在你自己电脑上的。个人学习足够了,但要记住两条:这个文件不要发给别人、不要传到网上;换电脑或不用了,记得去平台把 Key 删掉。第 5 章还会讲怎么防止它被 Git 提交出去。
3.4 PATH:终端去哪找命令
你敲 python3,终端怎么知道要运行哪个程序?它会看一个特别的环境变量,叫 PATH:里面是一串文件夹,终端按顺序一个个去找,找到同名的程序就运行,全找完还没有,就报「找不到」。
看 PATH 里有哪些文件夹:
echo $PATH$env:Path -split ";"macOS 会打出一长串用冒号隔开的文件夹,比如 /usr/local/bin:/usr/bin:/bin:...。Windows 那句会一行一个地列出来。
3.5 command not found 怎么查
我这台 Mac 上,真实的情况是这样:
% python --version
zsh: command not found: python
% python3 --version
Python 3.14.7
% which python3
/usr/local/bin/python3Python 装了,但只有叫 python3 的程序,没有叫 python 的。PATH 里的文件夹都找遍了,没有 python 这个名字,所以报错。
which(Windows 上用 where.exe)告诉你一条命令实际运行的是哪个文件,排查时最有用:
which python3
which pip3where.exe python
where.exe pip常见情况和对策:
| 现象 | 原因 | 对策 |
|---|---|---|
macOS:command not found: python | 系统只有 python3 | 用 python3、pip3,或者 python3 -m pip |
Windows:敲 python 弹出了应用商店 | 没装 Python,或者装的时候没勾选「Add python.exe to PATH」 | 从 python.org 重装,勾上那一项;或者用 py 启动器 |
| 刚装完,还是找不到 | 安装程序改了 PATH,但当前窗口还是旧的 | 关掉终端,重新打开 |
| 装了好几个版本,不知道用的是哪个 | PATH 里排在前面的先被找到 | 用 which / where.exe 看清楚 |
用 python3 -m pip 装包
pip install openai 有时会装到另一个 Python 上(你有好几个的时候)。写成 python3 -m pip install openai(Windows:py -m pip install openai),能保证装到你正在用的那个 Python 里。
试一试
- [ ] 开两个终端窗口,重复 3.2 的实验,亲眼看到「窗口 B 是空的」
- [ ] 按 3.3 把
DEEPSEEK_API_KEY长期保存,关掉所有终端,重新打开,用echo检查 - [ ] 用
which python3(Windows:where.exe python)看看你的 Python 在哪
本章小结
| 要点 | 说明 |
|---|---|
| 环境变量 | 终端里的一张「名字 = 值」纸条,运行的程序都能看到 |
| 临时设置 | export / $env: 只写在当前窗口,关掉就没 |
| 长期保存 | macOS 追加到 ~/.zshrc(用 >>);Windows 用 setx 或图形界面,设完新开窗口 |
| PATH | 终端找命令的文件夹清单;找不到就 command not found |
| 排查 | which / where.exe 看实际运行的是哪个;装完记得重开终端 |
下一章预告
周报生成器能稳定跑起来了。接下来你可能会让 AI 帮你改它:加功能、重构、修 bug。改好了皆大欢喜,改坏了呢?
下一章学 Git:改之前存个档,改坏了一条命令退回去。