Skip to content

第 3 章:环境变量和 PATH ​

本章目标:弄懂环境变量为什么「关掉终端就没了」,把 API Key 长期保存下来;看懂 command not found,知道 PATH 是怎么找命令的。

开篇:昨天还好好的 ​

《大模型 API 调用》第 1 章教你这样设 Key:

bash
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 可以看纸条上某个名字的值:

bash
echo $DEEPSEEK_API_KEY
powershell
echo $env:DEEPSEEK_API_KEY

有值就会打出来(注意别在别人面前、别在截图里这么做),没有就是一个空行。


3.2 为什么关掉就没了 ​

export(Windows 上是 $env:名字="值")只是在当前这个窗口的纸条上写了一行。新开的窗口有一张新的纸条,上面没有。

我用两个终端实际试了一下(为了不暴露真 Key,用了一个演示变量):

text
窗口 A:
% export DEMO_KEY="abc"
% echo "[$DEMO_KEY]"
[abc]

窗口 B(新开的):
% echo "[$DEMO_KEY]"
[]

窗口 A 里有,新开的窗口 B 里是空的。关掉窗口 A,它那张纸条也就没了。


3.3 长期保存:写进配置文件 ​

要让每个新窗口都自动带上这个变量,就得把它写进一个每次打开终端都会读的地方。

bash
# macOS 默认的终端(zsh)每次启动都会读 ~/.zshrc
echo 'export DEEPSEEK_API_KEY="sk-你的Key"' >> ~/.zshrc

# 让当前窗口也立刻生效(新窗口会自动读)
source ~/.zshrc

# 检查
echo $DEEPSEEK_API_KEY
powershell
# 写进当前用户的环境变量(永久保存)
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 里的文件夹顺序挨个找同名程序:找到就运行,全部找完还没有就报 command not found

看 PATH 里有哪些文件夹:

bash
echo $PATH
powershell
$env:Path -split ";"

macOS 会打出一长串用冒号隔开的文件夹,比如 /usr/local/bin:/usr/bin:/bin:...。Windows 那句会一行一个地列出来。


3.5 command not found 怎么查 ​

我这台 Mac 上,真实的情况是这样:

text
% python --version
zsh: command not found: python
% python3 --version
Python 3.14.7
% which python3
/usr/local/bin/python3

Python 装了,但只有叫 python3 的程序,没有叫 python 的。PATH 里的文件夹都找遍了,没有 python 这个名字,所以报错。

which(Windows 上用 where.exe)告诉你一条命令实际运行的是哪个文件,排查时最有用:

bash
which python3
which pip3
powershell
where.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:改之前存个档,改坏了一条命令退回去。

👉 第 4 章:Git:存档、看改动、退回去

本文阅读--次|全站访问--次|访客--人