设置环境变量时避坑：set不要引号不要空格，如：set API_KEY=.....

原创已于 2025-09-28 23:04:00 修改 · 1.1k 阅读

10 ·

CC 4.0 BY-SA版权

文章标签：

#python #环境变量

于 2025-09-25 22:14:51 首次发布

Python的高级知识同时被 2 个专栏收录

103 篇文章

订阅专栏

杂项

16 篇文章

订阅专栏

windows环境下，我程序中希望：api_key = “be0636c5812940a2b2a9f6110b8e2a3a”，通过在命令行中设置环境变量：set API_KEY=“be0636c5812940a2b2a9f6110b8e2a3a”
，之后再在程序中取出环境变量来实现程序中的赋值：api_key = os.getenv(“API_KEY”)。然而调试时程序出现错误，经排查发现：api_key != “be0636c5812940a2b2a9f6110b8e2a3a”，又一次掉进坑了，哈哈~~~

在前文设置环境变量的方法中，尤其是跨终端（如CMD、PowerShell、bash）或在程序中读取时，细节处理不当很容易导致“设置值与程序读取值不一致”的问题。如下的避坑总结一下，切记切记：

1. 引号处理：不同终端对引号的解析差异

这是最常见的“坑”，尤其是在 Windows 的 CMD 中：

Windows CMD 中：set API_KEY="be0636c5812940a2b2a9f6110b8e2a3a" 会将 双引号包含在变量值中。
即环境变量的实际值是 "be0636c5812940a2b2a9f6110b8e2a3a"（带引号），而不是你预期的 be0636c5812940a2b2a9f6110b8e2a3a（不带引号）。
程序中 os.getenv("API_KEY") 获取到的是带引号的值，自然与无引号的目标值不相等。

正确写法（CMD）：不要加引号，直接写值：

set API_KEY=be0636c5812940a2b2a9f6110b8e2a3a  # 无引号

特别指出：（CMD）中如下两项等价
```
set ABC=12345
set “ABC=12345”
```
特别指出：@set
（CMD）的.bat文件中，命令前加“@”，其作用是抑制命令回显，避免在控制台显示该命令本身。如：
```
@set ABC=12345
@set “ABC=12345”
```
其他终端对比：
- Linux/macOS 的 bash/zsh：export API_KEY="be0636..." 中，引号会被自动忽略，实际值不含引号（正确）。
- Windows PowerShell：$env:API_KEY = "be0636..." 中，引号也会被忽略，实际值不含引号（正确）。

2. 空格陷阱：等号前后不要有空格

环境变量的 变量名=值 格式中，等号前后不能有空格，否则会被解析为变量名或值的一部分：

错误示例（CMD/PowerShell/bash 均不允许）：

set API_KEY = be0636...  # 等号前后有空格，变量名会变成 "API_KEY "（带空格），值变成 " be0636..."（带空格）

正确示例：

set API_KEY=be0636...  # 等号前后无空格

3. 生效范围：确保在同一终端会话中使用

临时环境变量（通过 set/export 直接设置）仅在当前终端会话中有效。
例如：在 A 终端设置变量后，若在 B 终端运行程序，会读取不到变量（或读取旧值）。
解决：在 同一个终端 中先设置变量，再运行程序。

4. 永久生效设置的注意事项

若通过配置文件（如 Linux 的 .bashrc、Windows 的 setx）设置永久变量：

Windows setx 命令：
- 会自动截断超过 1024 字符的值，且设置后需 重启终端 才生效。
- 同样不要加引号，例如：
```
setx API_KEY be0636c5812940a2b2a9f6110b8e2a3a  # 正确，无引号
```
Linux/macOS 配置文件（如 .bashrc）：
写入 export API_KEY=be0636... 后，需执行 source ~/.bashrc 让当前会话生效，否则需重启终端。

5. 变量名大小写：跨系统一致性

Windows：环境变量名 不区分大小写（API_KEY 和 api_key 视为同一个）。
Linux/macOS：环境变量名 严格区分大小写（API_KEY 和 api_key 是两个不同变量）。
若程序中用 os.getenv("api_key") 读取，但环境变量设置为 API_KEY，在 Linux 中会读取失败（返回 None）。

6. 特殊字符处理：转义或避免敏感字符

若值中包含空格、&、= 等特殊字符：

Windows CMD：需用 双引号包裹值（但注意：此时引号会被包含在值中！）。
例如，值为 abc 123（带空格）：
```
set API_KEY="abc 123"  # 实际值是 "abc 123"（带引号），程序中需匹配带引号的值
```
若要避免引号，需用反斜杠转义空格（不推荐，易出错）：
```
set API_KEY=abc\ 123  # 仅 CMD 支持，值为 abc 123（无引号）
```
Linux/macOS bash：用单引号包裹值（单引号内的内容会被原样解析）：
```
export API_KEY='abc 123&xyz'  # 正确，值为 abc 123&xyz（无引号）
```

7. 程序中验证：先打印再调试

若程序中读取的值不符合预期，先打印环境变量的实际值，观察是否有多余字符（如引号、空格）：

import os

api_key = os.getenv("API_KEY")
print(f"实际读取到的API_KEY值：[{api_key}]")  # 用中括号包裹，清晰看到前后是否有空格/引号

例如，若输出 ["be0636..."]（带引号），说明设置时误加了引号，需修正设置命令。