easygoadmin-wiki/EasyGoAdmin_GoFrame_NaiveVue/zh/frontend/utils.md

9.16 工具函数

:::tip 概述 utils/ 提供通用工具：HTTP 封装（9.4 已述）、Storage 本地存储、auth 路径工具、downloadFile 下载、dateUtil/formatTime 时间、validate 校验、is 类型判断、urlUtils 等。本节速查常用函数。 :::

utils/ 工具地图

文件/目录	职责	常用函数
http/axios	HTTP 封装	http.request（详见 9.4）
Storage.ts	本地存储封装	storage.get/set/remove（token 等）
auth.ts	路由/树工具	getNormalPath、isExternal、findTreeByPath、objectToQuery
downloadFile.ts	文件下载	导出 URL 触发浏览器下载
dateUtil.ts / formatTime.ts	日期处理	dayjs 封装、格式化
validate.ts	校验	表单校验辅助
urlUtils.ts	URL 工具	setObjToUrlParams（参数拼接）
is/	类型判断	isString/isUrl/isEmpty…
helper/ lib/ file/	辅助函数库	按需探索
propTypes.ts	prop 类型	组件 prop 校验
color.ts	颜色	主题色处理
log.ts	日志	调试日志
lodashChunk.ts	分块	数组分块
useLockFn.ts	防重	函数锁（防连点）
wartermark.ts	水印	水印绘制

Storage（令牌存取核心）

import { storage } from '@/utils/Storage';

storage.get(ACCESS_TOKEN);      // 守卫/拦截器读取
storage.set(ACCESS_TOKEN, v);   // 登录写入
storage.remove(ACCESS_TOKEN);   // 登出清除

// ACCESS_TOKEN 键名常量在 store/mutation-types.ts

auth.ts 路径工具（守卫消费）

isExternal(path)        是否外链（https?:/mailto:/tel:）
getNormalPath(path)     路径归一（去重复斜杠/尾斜杠）
findTreeByPath          按 path 查菜单树节点（首个可达路由定位）
objectToQuery           对象转 query 字符串

下载与时间

// 导出下载：后端返回文件 URL → 触发浏览器下载
import { downloadFile } from '@/utils/downloadFile';
downloadFile(url);

// 日期：dayjs 封装
import { formatTime } from '@/utils/dateUtil';

hooks/ 配合（组合式复用）

hooks/core/     核心（useMessage 等）
hooks/setting/  useGlobSetting（读环境变量）/ useDesign（主题）
hooks/web/      useBattery/useOnline/useTime 等浏览器能力
hooks/event/    事件

使用规约

• 工具函数无业务依赖（不 import api/store）——保持纯函数/低耦合
• 新增公共工具放 utils/，仅页面用的放页面目录或 hooks
• 日期统一 dayjs（勿混用 moment/原生拼串）
• 本地存储统一 storage 封装（不直接 localStorage——便于前缀/过期管理）
• 类型判断用 is/ 目录（勿手写 toString 判断）