Reference · 打印出来贴在手边

运行时配置与接口环境

GameBox 客户端。源课：课 01。

一句话

运行时真值不在 .env，在 Pinia useGameEvn().ENV 和 sessionStorage GameENV 这两份副本里；service.ts 按 currentRouter 决定读哪一份。

四层链路

代码索引

ROUTE_CONFIG_MAP 全表

src/config/axios/service.ts:31-64。不在这张表里的路由一律落到默认分支 （VITE_API_PCODE / VITE_API_PATH）。

注意 /regionTagConfig 复用了 VITE_API_LOGINNOTICE_PCODE， /script 与 /newscript 的 pathKey 也不是各自的 *_SCRIPT_PATH。 这些看起来像笔误，但改之前必须先确认业务预期——线上可能正靠它工作。

currentRouter 写入点

「接口打错服务」四步分诊

Pinia 语法速查（本项目用到的全部）

// 定义（Options 式，本项目全部是这种）
export const useXxx = defineStore('id', {
  state: () => ({ foo: 1 }),        // 必须是函数
  getters: { double: (s) => s.foo * 2 },
  actions: { set(v) { this.foo = v } }  // this === store
})

// 组件内
const s = useXxx()
s.foo            // 直接读，不用 .value
s.set(2)         // 直接调 action
s.$patch({ foo: 3 })
s.$subscribe((mutation, state) => {})  // 官方推荐的持久化钩子

// 组件外（api / config / utils 里必须用这个）
import { store } from '@/store'
export const useXxxWithOut = () => useXxx(store)

禁忌

import.meta.env.DEV、VITE_BASEPATH、VITE_APP_TITLE 这类构建期常量不在禁忌之列——它们本来就不会被登录配置覆盖。