logo、系统名称等配置

上线前通常需要替换客户 Logo、系统名称、浏览器标题、App 名称，以及隐藏页面顶部的文档地址提示条。

Web 管理端

主工程：ruoyi-office-vben/apps/web-antd/

系统名称与浏览器标题

Web 端系统名称来自环境变量：

# ruoyi-office-vben/apps/web-antd/.env
VITE_APP_TITLE=企业管理一体化平台

该变量会影响：

• index.html 中的浏览器标题：<title>%VITE_APP_TITLE%</title>；
• apps/web-antd/src/preferences.ts 中的 app.name；
• 动态标题开启时的页面标题后缀；
• 页脚版权 copyright.companyName。

修改后需要重新构建 Web 管理端：

cd ruoyi-office-vben
pnpm build:antd

Logo 与 favicon

Web 端默认 Logo 配置在：

// ruoyi-office-vben/apps/web-antd/src/preferences.ts
logo: {
  enable: true,
  fit: 'contain',
  source: `${import.meta.env.BASE_URL}static/imgs/logo.png`,
},

常用替换位置：

内容	文件位置	说明
左上角 Logo / 登录页 Logo	apps/web-antd/public/static/imgs/logo.png	保持文件名不变可少改代码；如改文件名，同步修改 preferences.ts 的 logo.source
浏览器页签图标	apps/web-antd/public/favicon.ico	替换后建议清理浏览器缓存验证
暗色 Logo	preferences.ts 的 logo.sourceDark	如客户需要暗色主题 Logo，可增加该字段

如果 Web 部署在 /web/ 子路径，当前写法会通过 import.meta.env.BASE_URL 自动拼出 /web/static/imgs/logo.png。

文档地址提示条隐藏

系统中部分页面会展示 DocAlert 文档地址提示，例如角色管理页：

生产环境建议按需关闭，避免客户现场继续展示外部文档链接。

构建前关闭：

# ruoyi-office-vben/apps/web-antd/.env.production
VITE_APP_DOCALERT_ENABLE=false
VITE_GLOB_DOC_ALERT_ENABLE=false

生产包运行时关闭：修改部署产物中的 dist/_app.config.js 同名配置为 false，无需重新打包。开发环境如需预览文档提示条，可在 .env 中设置：

VITE_APP_DOCALERT_ENABLE=true

说明：VITE_GLOB_DOC_ALERT_ENABLE 是生产运行时配置，优先级高于构建时的 VITE_APP_DOCALERT_ENABLE。

App / H5 端

主工程：ruoyi-office-uniapp/

App 名称、H5 标题与页面标题

App 端系统名称来自 env/.env*：

# ruoyi-office-uniapp/env/.env
VITE_APP_TITLE = '企业管理一体化平台'
VITE_APP_SLOGAN = '高效办公'

相关使用位置：

内容	文件位置	说明
H5 浏览器标题	index.html、vite.config.ts	%VITE_APP_TITLE% 构建时注入
UniApp 应用名称	manifest.config.ts	name: VITE_APP_TITLE
全局导航栏标题	pages.config.ts	navigationBarTitleText: import.meta.env.VITE_APP_TITLE
首页口号	src/pages/index/index.vue	VITE_APP_TITLE / VITE_APP_SLOGAN
登录页版权	src/pages-core/auth/login.vue	使用 VITE_APP_TITLE

App Logo 与应用图标

常用替换位置：

内容	文件位置	说明
登录页 / 个人设置页 Logo	src/static/logo.png	src/pages-core/auth/components/header.vue、src/pages-core/user/settings/index.vue 默认引用
SVG Logo	src/static/logo.svg	README 或部分页面可能引用
App 安装图标	src/static/app/icons/	manifest.config.ts 的 app-plus.distribute.icons 指向这些尺寸
TabBar 图标	src/static/tabbar/ 或 src/tabbar/config.ts	根据当前 tabbar 方案替换

替换图标后建议分别验证 H5、App、微信小程序等目标端：

cd ruoyi-office-uniapp
pnpm dev
pnpm build

App 端文档入口隐藏

App 端没有统一的 DocAlert 提示条，常见文档入口在以下位置：

• src/pages/user/index.vue：个人中心「帮助中心」入口；
• src/pages-core/user/faq/data.ts：FAQ 中的文档地址内容；
• src/pages/index/index.vue：如首页有「更多文档」等业务入口，可按客户需求隐藏。

上线时如客户不需要对外文档链接，可删除对应入口、清空 FAQ 文档地址，或改为客户自己的帮助中心地址。