Easy-Vibe 环境变量与 PATH 完全指南从 Shell 命令查找到 API 密钥安全实践【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe导读在 Easy-Vibe 的 AI 原生开发实践中你每天都会遇到两个看似无关的问题——为什么刚装好的ollama提示command not found为什么代码里不能写死 API 密钥。答案都指向同一个底层机制环境变量。读完本文你将系统掌握 PATH 的查找规则、export/source的作用域原理以及从本地.env到云端平台注入的完整密钥管理链路并能在真实开发环境中快速排障。0. 每个运行中的程序都随身携带一套配置每一个正在运行的程序都持有一组形如keyvalue的配置项它们被称为环境变量environment variables。程序可以在任意时刻读取这些配置从而获知当前运行环境我在哪台机器上、我的家目录在哪里、系统默认编辑器是什么、该用哪把 API 密钥。在终端里执行以下命令即可查阅最常见的几个环境变量$ echo $HOME # 当前用户的家目录 $ echo $USER # 当前登录用户 $ echo $PATH # Shell 查找可执行程序的目录列表 $ echo $SHELL # 当前默认 Shell如 /bin/zsh $ env # 列出当前进程的全部环境变量这组配置并非只属于终端。当你从终端启动python、node或任何子进程时它们都会继承这份配置的副本——这正是后文密钥管理、部署注入的机制基础。与 Easy-Vibe 的关联当你运行仓库内的示例如examples/trae-3d-block-game时Node.js 进程同样通过环境变量感知运行环境。而 Dockerfile 与 nginx.conf 则展示了一个典型的构建期读取、运行期注入的部署模型——静态站点构建完成后真正对外提供服务的 Nginx 容器只需要端口与文件系统信息无需任何敏感环境变量。1. PATHShell 如何找到你敲下的命令PATH是一类特殊的环境变量它存储着一串目录路径列表在类 Unix 系统中以冒号:分隔。当你在终端输入gitShell 会按照 PATH 中目录的先后顺序逐个目录查找名为git的可执行文件——一旦找到第一个匹配立即停止搜索并执行它。$ echo $PATH /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin三条关键规则越靠前的目录优先级越高——排在 PATH 开头的目录最先被搜索找到即停——命中第一个匹配后就结束不再检查后面的目录全部目录都找不到→ 报错command not found。借助which命令可以验证 Shell 实际命中的是哪个文件$ which git /usr/local/bin/git # 这是 Shell 搜索 PATH 后找到的第一个 git结合 Easy-Vibe 的开发实践来看本项目仓库内的文档站点使用 Node.js 生态构建当你执行npm、node、git等命令时Shell 正是依赖 PATH 机制定位它们的。这也是为什么安装新工具后经常需要重开终端——详见下一节。2. 安装工具后为何要重启终端nvm / Homebrew / conda 场景安装 nvm、Homebrew、conda 这类工具时安装脚本通常会自动往~/.zshrc或~/.bashrc中追加一行把自己的目录加进 PATH# 安装脚本自动写入的内容示例 export PATH/usr/local/opt/python3.12/bin:$PATH关键点在于这行代码只在新 Shell 启动时才执行。已经打开的终端窗口不会重新加载配置文件所以旧窗口里仍然找不到新装的命令。此时不必重启终端只需手动重新执行配置文件# 无需重启即可立即生效 source ~/.zshrcAI 开发工具的高频踩坑场景在搭建 Easy-Vibe 这类 AI 应用开发环境时最常见的三个场景如下# 场景 1Ollama / pipx 安装后报 command not found which ollama # 先查实际安装位置确认是否只是 PATH 未覆盖 # 场景 2pip 安装的 CLI 工具不在 PATH 中 # macOS : ~/Library/Python/3.x/bin # Linux : ~/.local/bin export PATH$PATH:$HOME/.local/bin # 场景 3推荐用 pipx 安装 CLI 工具自动托管 PATH pipx install aider-chat其中pipx的价值在于它把每个 CLI 工具隔离在自己的虚拟环境中同时自动把可执行文件软链到全局 bin 目录免去手动维护 PATH 的烦恼——这与 Easy-Vibe 强调的让 AI 替你搭建环境、少踩手工配置坑的理念一致。仓库文档 docs/fr-fr/appendix/2-development-tools/package-managers.md 中对包管理器有更系统的讲解。3. 变量作用域谁能看到这个变量环境变量不会广播给所有程序——每个进程持有的是自己的一份副本这份副本从父进程继承而来。你在当前终端修改自己的副本父进程或兄弟进程完全不受影响。用一个小实验即可验证# 终端 A父进程 $ export MY_VARhello $ bash # 启动一个子 Shell子进程 # 子 Shell 中 $ echo $MY_VAR # 输出 hello —— 从父进程继承 # 回到父 Shellexit 退出子 Shell $ unset MY_VAR $ bash $ echo $MY_VAR # 输出为空 —— 子进程启动后不再感知父进程后续的修改结论环境变量的传递是启动时一次性快照式的继承而非实时的共享广播。因此跨会话跨终端窗口、跨重启需要持久化的变量必须写入配置文件见第 4 节。4. export决定子进程能否读到这个变量定义变量时加不加export有本质区别$ MY_VARvalue # 仅当前 Shell 可见子进程读不到 $ export MY_VARvalue # 标记为可继承子进程启动时自动获得一份副本用一段命令直观验证$ VAR_Aonly-me $ export VAR_Bshared $ bash -c echo $VAR_A; echo $VAR_B # 第一行输出为空VAR_A 未被继承 # 第二行输出 sharedVAR_B 被继承要想让变量跨会话持久就把export语句写进 Shell 配置文件# macOSzsh echo export MY_VARvalue ~/.zshrc source ~/.zshrc # 立即生效无需重启终端 # Linuxbash echo export MY_VARvalue ~/.bashrc source ~/.bashrc进阶提示.zshrc是交互式 Shell 启动时加载的配置而登录 Shell 还可能加载.zprofile、.zshenv等文件。日常开发中把环境变量统一放在.zshrcmacOS/zsh或.bashrcLinux/bash是最简单可靠的做法。5. API 密钥永远不要写死在源码里当你调用 OpenAI、Anthropic、DeepSeek 等大模型 API 时密钥API Key相当于你的身份证 信用卡。一旦泄露他人就能消耗你的配额费用由你承担。最常见的错误就是把密钥直接写进源码# ❌ 错误示范密钥写死在源码里 client OpenAI(api_keysk-xxxxxxxxxxxxxxxxxxxxxxxx)// ❌ 错误示范 const openai new OpenAI({ apiKey: sk-xxxxxxxxxxxxxxxxxxxxxxxx });写死的密钥会随代码进入 Git 历史、被复制粘贴、被提交到公开仓库——即使事后删除历史记录里依然留存。仓库文档 docs/fr-fr/appendix/2-development-tools/git-version-control.md 中强调的版本控制纪律与密钥安全直接相关密钥一旦提交就应该视为已泄露并立即吊销更换。正确姿势通过环境变量读取密钥——代码只声明我需要一把叫OPENAI_API_KEY的钥匙至于钥匙值从哪来本地.env还是云端平台注入代码完全不关心# ✅ 正确示范 import os client OpenAI(api_keyos.environ[OPENAI_API_KEY])// ✅ 正确示范 const openai new OpenAI({ apiKey: process.env.OPENAI_API_KEY });6. 本地开发用 .env 文件管理密钥在本地开发阶段把密钥存放在项目根目录的.env文件中代码通过 dotenv 类库读取# .env项目根目录 OPENAI_API_KEYsk-xxxxxxxxxxxx DATABASE_URLpostgres://user:passlocalhost:5432/app# Python使用 python-dotenv pip install python-dotenv from dotenv import load_dotenv import os load_dotenv() # 把 .env 中的键值加载为环境变量 api_key os.getenv(OPENAI_API_KEY)// Node.js使用 dotenv npm install dotenv require(dotenv).config(); // 读取根目录 .env const apiKey process.env.OPENAI_API_KEY;铁律.env必须加入.gitignore绝不能提交进 Git。同时提供一个.env.example模板——变量名完整、值留空这个文件可以安全提交方便协作者复制为.env后填入自己的密钥# .env.example可提交到 Git OPENAI_API_KEY DATABASE_URL关于 dotenv 在 Node 生态的实际使用Easy-Vibe 仓库的示例项目有据可查examples/trae-3d-block-game/package-lock.json中包含了dotenv^9.0.2与dotenv-expand^5.1.0依赖表明该示例的 Node 工具链正是通过 dotenv 体系加载环境配置的。密钥文件权限加固对敏感配置文件如.env、私钥文件用chmod 600收紧权限——仅属主可读写chmod 600 .env ls -l .env # -rw------- 1 user user ... .env7. 生产环境让运行平台注入密钥.env只是开发阶段的便利工具。在服务器和云平台上密钥应该由运行环境负责注入——代码本身完全不需要知道密钥存放在哪里。这样才能做到密钥不出现在代码仓库、构建产物中不同环境开发/测试/生产可以使用不同的密钥而无需改代码密钥的轮换、吊销由平台统一管理。Easy-Vibe 仓库自身的部署配置就是构建期无密钥、运行期由平台管理的典型见 Dockerfile 与 nginx.conf——构建阶段只编译 VitePress 静态文档站点运行阶段由 Nginx 提供服务全程不涉及任何 API 密钥的注入或打包。主流平台的密钥注入方式1. 云平台控制台Vercel / Railway / Fly.io / 魔搭等在平台的环境变量设置页面逐个配置即可如DATABASE_URLxxx JWT_SECRETxxx OPENAI_API_KEYxxx这正是仓库文档 docs/en/stage-2/backend/cloud-server-deployment/index.md 中通用部署提示词模板所列举的必填项——部署时把环境变量清单交给 AI由它帮你完成平台侧的配置。2. systemd 服务自建 VPS 场景# /etc/systemd/system/myapp.service [Service] EnvironmentFile/etc/myapp.env ExecStart/usr/local/bin/myapp其中/etc/myapp.env内容形如DATABASE_URLxxx OPENAI_API_KEYxxx随后sudo systemctl daemon-reload sudo systemctl restart myapp即可生效。相比把变量直接写进 service 文件EnvironmentFile方式便于独立管理密钥文件配合chmod 600保护。3. Docker / Docker Compose# docker-compose.yml services: app: image: myapp:latest environment: - DATABASE_URL${DATABASE_URL} - OPENAI_API_KEY${OPENAI_API_KEY}宿主机上的密钥可通过.env或 shell 导出提供给 compose 文件解析。安全原则总结开发环境用.env配合 dotenv 加载生产环境用平台注入环境变量或 secret 管理服务。代码中只通过os.environ/process.env读取永远不要把密钥文件带入构建产物。仓库文档 docs/en/stage-2/backend/database-supabase/index.md 中的 Supabase 示例同样印证了这一模式——OPENAI_API_KEY作为环境变量安全存储在服务端前端代码完全无法接触。8. 实战排障手册8.1command not found# 第 1 步确认程序是否已在 PATH 中 which python3 # 有输出说明已找到无输出说明不在 PATH # 第 2 步找到程序的真实安装位置以 macOS Homebrew 为例 brew list python | grep bin # 第 3 步把该目录加入 PATH export PATH/找到的路径:$PATH # 写入配置文件后记得 source 使其永久且立即生效 source ~/.zshrc8.2 装了两个版本用的却不是想要的那个$ which python /usr/bin/python # ← 系统旧版本在 PATH 中靠前被优先命中 # 把新版本目录放到 PATH 最前面前置覆盖 export PATH/usr/local/bin:$PATH $ which python /usr/local/bin/python # ← 新版本现在获得优先权这正是第 1 节PATH 顺序即优先级规则的直接应用——把想用的版本目录前置即可覆盖旧版本。8.3 变量明明设置了程序却读不到可能原因解决方案忘记加export加上export重新设置修改了~/.zshrc但未生效执行source ~/.zshrc用了.env但没装 dotenvpip install python-dotenv/npm install dotenv服务器上仅当前 SSH 会话生效改用 systemd 的EnvironmentFile配置8.4 密钥疑似泄露时的应急响应立即到对应平台吊销/轮换该密钥绝大多数云平台支持一键 revoke使用git log -p检查是否曾提交进版本库若有则视为已泄露处理把密钥从代码中移除改为环境变量读取开启平台的Secret Scanner见下文术语表利用自动化扫描提前发现风险。术语速查表术语含义PATH存储 Shell 查找可执行文件的目录列表冒号分隔顺序决定优先级export将变量标记为可继承子进程启动时自动获得一份副本source在当前 Shell 中重新执行配置文件使修改立即生效which显示某条命令对应的可执行文件路径即 PATH 搜索的结果.env项目本地配置文件存放开发密钥必须加入.gitignore.env.example变量名齐全、值留空的模板文件可安全提交到 Gitchmod 600文件权限仅属主可读写适合保护密钥类文件Secret ScannerGitHub 等平台的自动扫描功能发现密钥泄露后通知服务商吊销小结从 Shell 查找命令的PATH机制到export/source的作用域原理再到本地.env与生产平台注入的密钥管理链路环境变量贯穿了 AI 应用开发的每一个环节。记住三条主线即可命令找不到→ 检查 PATH 是否包含程序目录用which定位用前置路径调整优先级变量不生效→ 检查是否export、是否source配置文件、进程是否重新启动密钥不安全→ 本地用.env dotenv并加入.gitignore生产交给平台注入代码只认环境变量。掌握了这套机制你在搭建 Easy-Vibe 开发环境、接入大模型 API 或部署上线时就能少踩一半的环境配置坑。【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Easy-Vibe 环境变量与 PATH 完全指南：从 Shell 命令查找到 API 密钥安全实践
Easy-Vibe 环境变量与 PATH 完全指南从 Shell 命令查找到 API 密钥安全实践【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe导读在 Easy-Vibe 的 AI 原生开发实践中你每天都会遇到两个看似无关的问题——为什么刚装好的ollama提示command not found为什么代码里不能写死 API 密钥。答案都指向同一个底层机制环境变量。读完本文你将系统掌握 PATH 的查找规则、export/source的作用域原理以及从本地.env到云端平台注入的完整密钥管理链路并能在真实开发环境中快速排障。0. 每个运行中的程序都随身携带一套配置每一个正在运行的程序都持有一组形如keyvalue的配置项它们被称为环境变量environment variables。程序可以在任意时刻读取这些配置从而获知当前运行环境我在哪台机器上、我的家目录在哪里、系统默认编辑器是什么、该用哪把 API 密钥。在终端里执行以下命令即可查阅最常见的几个环境变量$ echo $HOME # 当前用户的家目录 $ echo $USER # 当前登录用户 $ echo $PATH # Shell 查找可执行程序的目录列表 $ echo $SHELL # 当前默认 Shell如 /bin/zsh $ env # 列出当前进程的全部环境变量这组配置并非只属于终端。当你从终端启动python、node或任何子进程时它们都会继承这份配置的副本——这正是后文密钥管理、部署注入的机制基础。与 Easy-Vibe 的关联当你运行仓库内的示例如examples/trae-3d-block-game时Node.js 进程同样通过环境变量感知运行环境。而 Dockerfile 与 nginx.conf 则展示了一个典型的构建期读取、运行期注入的部署模型——静态站点构建完成后真正对外提供服务的 Nginx 容器只需要端口与文件系统信息无需任何敏感环境变量。1. PATHShell 如何找到你敲下的命令PATH是一类特殊的环境变量它存储着一串目录路径列表在类 Unix 系统中以冒号:分隔。当你在终端输入gitShell 会按照 PATH 中目录的先后顺序逐个目录查找名为git的可执行文件——一旦找到第一个匹配立即停止搜索并执行它。$ echo $PATH /usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin三条关键规则越靠前的目录优先级越高——排在 PATH 开头的目录最先被搜索找到即停——命中第一个匹配后就结束不再检查后面的目录全部目录都找不到→ 报错command not found。借助which命令可以验证 Shell 实际命中的是哪个文件$ which git /usr/local/bin/git # 这是 Shell 搜索 PATH 后找到的第一个 git结合 Easy-Vibe 的开发实践来看本项目仓库内的文档站点使用 Node.js 生态构建当你执行npm、node、git等命令时Shell 正是依赖 PATH 机制定位它们的。这也是为什么安装新工具后经常需要重开终端——详见下一节。2. 安装工具后为何要重启终端nvm / Homebrew / conda 场景安装 nvm、Homebrew、conda 这类工具时安装脚本通常会自动往~/.zshrc或~/.bashrc中追加一行把自己的目录加进 PATH# 安装脚本自动写入的内容示例 export PATH/usr/local/opt/python3.12/bin:$PATH关键点在于这行代码只在新 Shell 启动时才执行。已经打开的终端窗口不会重新加载配置文件所以旧窗口里仍然找不到新装的命令。此时不必重启终端只需手动重新执行配置文件# 无需重启即可立即生效 source ~/.zshrcAI 开发工具的高频踩坑场景在搭建 Easy-Vibe 这类 AI 应用开发环境时最常见的三个场景如下# 场景 1Ollama / pipx 安装后报 command not found which ollama # 先查实际安装位置确认是否只是 PATH 未覆盖 # 场景 2pip 安装的 CLI 工具不在 PATH 中 # macOS : ~/Library/Python/3.x/bin # Linux : ~/.local/bin export PATH$PATH:$HOME/.local/bin # 场景 3推荐用 pipx 安装 CLI 工具自动托管 PATH pipx install aider-chat其中pipx的价值在于它把每个 CLI 工具隔离在自己的虚拟环境中同时自动把可执行文件软链到全局 bin 目录免去手动维护 PATH 的烦恼——这与 Easy-Vibe 强调的让 AI 替你搭建环境、少踩手工配置坑的理念一致。仓库文档 docs/fr-fr/appendix/2-development-tools/package-managers.md 中对包管理器有更系统的讲解。3. 变量作用域谁能看到这个变量环境变量不会广播给所有程序——每个进程持有的是自己的一份副本这份副本从父进程继承而来。你在当前终端修改自己的副本父进程或兄弟进程完全不受影响。用一个小实验即可验证# 终端 A父进程 $ export MY_VARhello $ bash # 启动一个子 Shell子进程 # 子 Shell 中 $ echo $MY_VAR # 输出 hello —— 从父进程继承 # 回到父 Shellexit 退出子 Shell $ unset MY_VAR $ bash $ echo $MY_VAR # 输出为空 —— 子进程启动后不再感知父进程后续的修改结论环境变量的传递是启动时一次性快照式的继承而非实时的共享广播。因此跨会话跨终端窗口、跨重启需要持久化的变量必须写入配置文件见第 4 节。4. export决定子进程能否读到这个变量定义变量时加不加export有本质区别$ MY_VARvalue # 仅当前 Shell 可见子进程读不到 $ export MY_VARvalue # 标记为可继承子进程启动时自动获得一份副本用一段命令直观验证$ VAR_Aonly-me $ export VAR_Bshared $ bash -c echo $VAR_A; echo $VAR_B # 第一行输出为空VAR_A 未被继承 # 第二行输出 sharedVAR_B 被继承要想让变量跨会话持久就把export语句写进 Shell 配置文件# macOSzsh echo export MY_VARvalue ~/.zshrc source ~/.zshrc # 立即生效无需重启终端 # Linuxbash echo export MY_VARvalue ~/.bashrc source ~/.bashrc进阶提示.zshrc是交互式 Shell 启动时加载的配置而登录 Shell 还可能加载.zprofile、.zshenv等文件。日常开发中把环境变量统一放在.zshrcmacOS/zsh或.bashrcLinux/bash是最简单可靠的做法。5. API 密钥永远不要写死在源码里当你调用 OpenAI、Anthropic、DeepSeek 等大模型 API 时密钥API Key相当于你的身份证 信用卡。一旦泄露他人就能消耗你的配额费用由你承担。最常见的错误就是把密钥直接写进源码# ❌ 错误示范密钥写死在源码里 client OpenAI(api_keysk-xxxxxxxxxxxxxxxxxxxxxxxx)// ❌ 错误示范 const openai new OpenAI({ apiKey: sk-xxxxxxxxxxxxxxxxxxxxxxxx });写死的密钥会随代码进入 Git 历史、被复制粘贴、被提交到公开仓库——即使事后删除历史记录里依然留存。仓库文档 docs/fr-fr/appendix/2-development-tools/git-version-control.md 中强调的版本控制纪律与密钥安全直接相关密钥一旦提交就应该视为已泄露并立即吊销更换。正确姿势通过环境变量读取密钥——代码只声明我需要一把叫OPENAI_API_KEY的钥匙至于钥匙值从哪来本地.env还是云端平台注入代码完全不关心# ✅ 正确示范 import os client OpenAI(api_keyos.environ[OPENAI_API_KEY])// ✅ 正确示范 const openai new OpenAI({ apiKey: process.env.OPENAI_API_KEY });6. 本地开发用 .env 文件管理密钥在本地开发阶段把密钥存放在项目根目录的.env文件中代码通过 dotenv 类库读取# .env项目根目录 OPENAI_API_KEYsk-xxxxxxxxxxxx DATABASE_URLpostgres://user:passlocalhost:5432/app# Python使用 python-dotenv pip install python-dotenv from dotenv import load_dotenv import os load_dotenv() # 把 .env 中的键值加载为环境变量 api_key os.getenv(OPENAI_API_KEY)// Node.js使用 dotenv npm install dotenv require(dotenv).config(); // 读取根目录 .env const apiKey process.env.OPENAI_API_KEY;铁律.env必须加入.gitignore绝不能提交进 Git。同时提供一个.env.example模板——变量名完整、值留空这个文件可以安全提交方便协作者复制为.env后填入自己的密钥# .env.example可提交到 Git OPENAI_API_KEY DATABASE_URL关于 dotenv 在 Node 生态的实际使用Easy-Vibe 仓库的示例项目有据可查examples/trae-3d-block-game/package-lock.json中包含了dotenv^9.0.2与dotenv-expand^5.1.0依赖表明该示例的 Node 工具链正是通过 dotenv 体系加载环境配置的。密钥文件权限加固对敏感配置文件如.env、私钥文件用chmod 600收紧权限——仅属主可读写chmod 600 .env ls -l .env # -rw------- 1 user user ... .env7. 生产环境让运行平台注入密钥.env只是开发阶段的便利工具。在服务器和云平台上密钥应该由运行环境负责注入——代码本身完全不需要知道密钥存放在哪里。这样才能做到密钥不出现在代码仓库、构建产物中不同环境开发/测试/生产可以使用不同的密钥而无需改代码密钥的轮换、吊销由平台统一管理。Easy-Vibe 仓库自身的部署配置就是构建期无密钥、运行期由平台管理的典型见 Dockerfile 与 nginx.conf——构建阶段只编译 VitePress 静态文档站点运行阶段由 Nginx 提供服务全程不涉及任何 API 密钥的注入或打包。主流平台的密钥注入方式1. 云平台控制台Vercel / Railway / Fly.io / 魔搭等在平台的环境变量设置页面逐个配置即可如DATABASE_URLxxx JWT_SECRETxxx OPENAI_API_KEYxxx这正是仓库文档 docs/en/stage-2/backend/cloud-server-deployment/index.md 中通用部署提示词模板所列举的必填项——部署时把环境变量清单交给 AI由它帮你完成平台侧的配置。2. systemd 服务自建 VPS 场景# /etc/systemd/system/myapp.service [Service] EnvironmentFile/etc/myapp.env ExecStart/usr/local/bin/myapp其中/etc/myapp.env内容形如DATABASE_URLxxx OPENAI_API_KEYxxx随后sudo systemctl daemon-reload sudo systemctl restart myapp即可生效。相比把变量直接写进 service 文件EnvironmentFile方式便于独立管理密钥文件配合chmod 600保护。3. Docker / Docker Compose# docker-compose.yml services: app: image: myapp:latest environment: - DATABASE_URL${DATABASE_URL} - OPENAI_API_KEY${OPENAI_API_KEY}宿主机上的密钥可通过.env或 shell 导出提供给 compose 文件解析。安全原则总结开发环境用.env配合 dotenv 加载生产环境用平台注入环境变量或 secret 管理服务。代码中只通过os.environ/process.env读取永远不要把密钥文件带入构建产物。仓库文档 docs/en/stage-2/backend/database-supabase/index.md 中的 Supabase 示例同样印证了这一模式——OPENAI_API_KEY作为环境变量安全存储在服务端前端代码完全无法接触。8. 实战排障手册8.1command not found# 第 1 步确认程序是否已在 PATH 中 which python3 # 有输出说明已找到无输出说明不在 PATH # 第 2 步找到程序的真实安装位置以 macOS Homebrew 为例 brew list python | grep bin # 第 3 步把该目录加入 PATH export PATH/找到的路径:$PATH # 写入配置文件后记得 source 使其永久且立即生效 source ~/.zshrc8.2 装了两个版本用的却不是想要的那个$ which python /usr/bin/python # ← 系统旧版本在 PATH 中靠前被优先命中 # 把新版本目录放到 PATH 最前面前置覆盖 export PATH/usr/local/bin:$PATH $ which python /usr/local/bin/python # ← 新版本现在获得优先权这正是第 1 节PATH 顺序即优先级规则的直接应用——把想用的版本目录前置即可覆盖旧版本。8.3 变量明明设置了程序却读不到可能原因解决方案忘记加export加上export重新设置修改了~/.zshrc但未生效执行source ~/.zshrc用了.env但没装 dotenvpip install python-dotenv/npm install dotenv服务器上仅当前 SSH 会话生效改用 systemd 的EnvironmentFile配置8.4 密钥疑似泄露时的应急响应立即到对应平台吊销/轮换该密钥绝大多数云平台支持一键 revoke使用git log -p检查是否曾提交进版本库若有则视为已泄露处理把密钥从代码中移除改为环境变量读取开启平台的Secret Scanner见下文术语表利用自动化扫描提前发现风险。术语速查表术语含义PATH存储 Shell 查找可执行文件的目录列表冒号分隔顺序决定优先级export将变量标记为可继承子进程启动时自动获得一份副本source在当前 Shell 中重新执行配置文件使修改立即生效which显示某条命令对应的可执行文件路径即 PATH 搜索的结果.env项目本地配置文件存放开发密钥必须加入.gitignore.env.example变量名齐全、值留空的模板文件可安全提交到 Gitchmod 600文件权限仅属主可读写适合保护密钥类文件Secret ScannerGitHub 等平台的自动扫描功能发现密钥泄露后通知服务商吊销小结从 Shell 查找命令的PATH机制到export/source的作用域原理再到本地.env与生产平台注入的密钥管理链路环境变量贯穿了 AI 应用开发的每一个环节。记住三条主线即可命令找不到→ 检查 PATH 是否包含程序目录用which定位用前置路径调整优先级变量不生效→ 检查是否export、是否source配置文件、进程是否重新启动密钥不安全→ 本地用.env dotenv并加入.gitignore生产交给平台注入代码只认环境变量。掌握了这套机制你在搭建 Easy-Vibe 开发环境、接入大模型 API 或部署上线时就能少踩一半的环境配置坑。【免费下载链接】easy-vibe vibe coding 101The first course for AI-native product builders.项目地址: https://gitcode.com/GitHub_Trending/ea/easy-vibe创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考