Postman 环境变量怎么区分初始值与当前值

如果你看到旧教程里的 Initial value 和 Current value，可以先这样对应：Current value 是当前实例实际发请求时使用的本地值，现在叫 Local value；Initial value 是曾经用于团队同步的值，现在叫 Shared value。当前 Postman 桌面端和 Web 端已经不再用两个可独立编辑的旧字段来维护它们，而是默认保存一个本地值，需要协作时再明确分享为共享值。

官方地址：https://learning.postman.com/docs/use/send-requests/variables/variables/

旧称与新称到底怎么对应

Postman 变量界面经历过一次重要变化。过去一个环境变量可以同时显示 Current value 和 Initial value，很多教程仍沿用这组称呼。现在的官方文档使用 Local value 与 Shared value，而且强调变量默认只有本地值；只有主动执行 Share，值才会同步到 Postman cloud。

这里的“对应”指用途迁移，不代表新版又恢复了两个必须同时填写的独立字段。新版以 Local value 为默认工作值；共享后可以保留一个 Shared value，之后继续修改本地值也不会自动覆盖共享值。Postman VS Code 扩展仍支持 Initial value 与 Current value 命名，因此同一团队有人使用扩展、有人使用桌面端时，看到不同术语并不矛盾。

步骤一：打开环境并填写本地值

1. 在左侧选择 Items，展开 Environments，打开要使用的环境，例如 Local API。
2. 新增变量 base_url，在值字段中填写用于个人调试的地址，例如 https://api.example.test。当前界面会自动保存变量修改。
3. 回到工作台，在右上角环境选择器中选中 Local API，让它成为 Active environment。

可见的成功状态：右上角环境选择器显示 Local API，环境变量表里的 base_url 有本地值。此时请求 URL 写成 {{base_url}}/health，Postman 会在当前实例中解析为本地地址。修改本地值不会自动把新值分享给队友。

步骤二：需要协作时再创建共享值

1. 仍在目标环境中，点击 More，启用 Shared Value 视图，便于同时观察本地值和共享值。
2. 若变量从未共享，点击值旁边的 Share；需要一次共享多个变量时，可使用 More > Share all。
3. 本地值后来发生变化时，界面会出现已编辑状态。确认新值适合团队使用后，再选择 Update shared value；不要把个人测试值无意中推给全组。

可见的成功状态：变量旁显示已同步状态，或 Shared Value 列出现共享值。共享值可供工作区成员使用，也会被监视器、计划运行和 Postman CLI 等部分云端功能采用。只有拥有相应 Editor 权限的成员才能创建或更新共享值。

步骤三：在请求里确认实际解析的是哪一个值

1. 打开引用了 {{base_url}} 的请求，确认右上角仍选中了正确环境。
2. 点击工作台右上角的 Variables，在 Variables in request 中查看当前请求引用的变量。
3. 核对 base_url 显示的 Local value，再把鼠标悬停在请求 URL 的变量引用上，确认解析结果与预期一致。
4. 发送请求后，只把响应状态当作接口结果；变量是否正确，应以 Variables 面板里的解析值和激活环境为准。

如果 URL 中的变量被标红，常见原因不是“Initial value 没填”，而是当前变量没有值、目标环境未激活、变量被关闭，或者变量根本不在当前请求可访问的作用域。先在 Variables 面板查看 All variables，再检查环境选择器和变量开关。

本地值与共享值不一致时怎么处理

本地调试期间，两者不同是正常状态。例如团队共享值是测试环境地址，而你临时把 Local value 改成了本机服务地址。只要不点击 Update shared value，队友的共享值不会被你的修改覆盖。

• 想保留个人调试值：继续使用 Local value，不做共享操作。
• 想把新值交给团队：检查内容无敏感信息，再执行 Update shared value。
• 想恢复团队默认值：点击变量旁的已编辑图标，选择 Reset value；需要批量恢复时用 More > Reset all shared values。
• 云端运行拿不到值：确认变量已经共享。只有本地值时，监视器、计划运行或 Postman CLI 可能无法取得该值。

敏感值不要当普通初始值共享

旧教程有时会建议把公共 Token 写进 Initial value，这种做法不适合直接照搬。普通 Shared value 会同步到 Postman cloud，并可能随公开文档一起发布。密码、Token 和 API Key 应设置为 Secure variable，或存进 Postman Vault；如果确实需要团队共享秘密，应使用 Shared Vault，并把“共享秘密”和“共享变量引用”作为两个明确动作处理。

可以用下面这份清单做最终核对：

• 右上角是否激活了正确环境；
• 请求里的变量是否显示 Local value；
• 需要云端执行的变量是否已经创建 Shared value；
• 个人测试地址是否没有误点 Update shared value；
• 密码、Token、API Key 是否没有出现在普通共享值中。

常见问题

为什么我的 Postman 找不到 Initial value 和 Current value 两列？
因为当前桌面端和 Web 端已经改用 Local value 与 Shared value 模型，不再维护旧版两个独立字段。VS Code 扩展仍可能显示 Initial/Current 命名。

发送请求时到底使用哪个值？
当前 Postman 实例发送请求时使用激活环境中的 Local value。云端功能通常使用 Shared value。

修改 Local value 会自动更新 Shared value 吗？
不会。需要主动选择 Update shared value；这样可以避免个人调试值意外影响团队。

Shared value 可以放 Token 吗？
不建议把敏感值直接放入普通共享值。使用 Secure variable 或 Vault，并根据团队权限决定是否进入 Shared Vault。