ray-template/docs/reference/configuration.html

26 lines
35 KiB
HTML
Raw Blame History

This file contains invisible Unicode characters

This file contains invisible Unicode characters that are indistinguishable to humans but may be processed differently by a computer. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

<!DOCTYPE html>
<html lang="zh-CN" dir="ltr">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width,initial-scale=1">
<title>应用配置 · Ray Template 文档</title>
<meta name="description" content="Ray Template 6.0.0 的 Monorepo 架构、版本分界、组件与交互示例。">
<meta name="generator" content="VitePress v1.6.4">
<link rel="preload stylesheet" href="/ray-template/docs/assets/style.DWpwjkO1.css" as="style">
<link rel="preload stylesheet" href="/ray-template/docs/vp-icons.css" as="style">
<script type="module" src="/ray-template/docs/assets/app.D3fNAuSv.js"></script>
<link rel="preload" href="/ray-template/docs/assets/inter-roman-latin.Di8DUHzh.woff2" as="font" type="font/woff2" crossorigin="">
<link rel="modulepreload" href="/ray-template/docs/assets/chunks/theme.BrxnH68g.js">
<link rel="modulepreload" href="/ray-template/docs/assets/chunks/framework.DdJ92B9j.js">
<link rel="modulepreload" href="/ray-template/docs/assets/reference_configuration.md.BCh89HnV.lean.js">
<link rel="icon" type="image/svg+xml" href="/ray-template/docs/ray-mark.svg">
<script id="check-dark-mode">(()=>{const e=localStorage.getItem("vitepress-theme-appearance")||"auto",a=window.matchMedia("(prefers-color-scheme: dark)").matches;(!e||e==="auto"?a:e==="dark")&&document.documentElement.classList.add("dark")})();</script>
<script id="check-mac-os">document.documentElement.classList.toggle("mac",/Mac|iPhone|iPod|iPad/i.test(navigator.platform));</script>
</head>
<body>
<div id="app"><div class="Layout" data-v-f9c03b6e><!--[--><!--]--><!--[--><span tabindex="-1" data-v-770676c7></span><a href="#VPContent" class="VPSkipLink visually-hidden" data-v-770676c7>跳转到正文</a><!--]--><!----><header class="VPNav" data-v-f9c03b6e data-v-b2a7789c><div class="VPNavBar" data-v-b2a7789c data-v-d231c45b><div class="wrapper" data-v-d231c45b><div class="container" data-v-d231c45b><div class="title" data-v-d231c45b><div class="VPNavBarTitle has-sidebar" data-v-d231c45b data-v-49754884><a class="title" href="/ray-template/docs/" data-v-49754884><!--[--><!--]--><!--[--><img class="VPImage logo" src="/ray-template/docs/ray-mark.svg" alt data-v-a9cdc337><!--]--><span data-v-49754884>Ray Template</span><!--[--><!--]--></a></div></div><div class="content" data-v-d231c45b><div class="content-body" data-v-d231c45b><!--[--><!--]--><div class="VPNavBarSearch search" data-v-d231c45b><!--[--><!----><div id="local-search"><button type="button" class="DocSearch DocSearch-Button" aria-label="搜索文档"><span class="DocSearch-Button-Container"><span class="vp-icon DocSearch-Search-Icon"></span><span class="DocSearch-Button-Placeholder">搜索文档</span></span><span class="DocSearch-Button-Keys"><kbd class="DocSearch-Button-Key"></kbd><kbd class="DocSearch-Button-Key">K</kbd></span></button></div><!--]--></div><nav aria-labelledby="main-nav-aria-label" class="VPNavBarMenu menu" data-v-d231c45b data-v-49bcf2ef><span id="main-nav-aria-label" class="visually-hidden" data-v-49bcf2ef> Main Navigation </span><!--[--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/ray-template/docs/guide/start.html" tabindex="0" data-v-49bcf2ef data-v-991603b8><!--[--><span data-v-991603b8>指南</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/ray-template/docs/guide/architecture.html" tabindex="0" data-v-49bcf2ef data-v-991603b8><!--[--><span data-v-991603b8>架构</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink" href="/ray-template/docs/migration.html" tabindex="0" data-v-49bcf2ef data-v-991603b8><!--[--><span data-v-991603b8>版本分界</span><!--]--></a><!--]--><!--[--><a class="VPLink link VPNavBarMenuLink active" href="/ray-template/docs/reference/" tabindex="0" data-v-49bcf2ef data-v-991603b8><!--[--><span data-v-991603b8>API 参考</span><!--]--></a><!--]--><!--[--><a class="VPLink link vp-external-link-icon VPNavBarMenuLink" href="https://xiaodaigua-ray.github.io/ray-template/" target="_blank" rel="noreferrer" tabindex="0" data-v-49bcf2ef data-v-991603b8><!--[--><span data-v-991603b8>Ray Admin</span><!--]--></a><!--]--><!--]--></nav><!----><div class="VPNavBarAppearance appearance" data-v-d231c45b data-v-a4a103b4><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-a4a103b4 data-v-2b76c23f data-v-54e91c08><span class="check" data-v-54e91c08><span class="icon" data-v-54e91c08><!--[--><span class="vpi-sun sun" data-v-2b76c23f></span><span class="vpi-moon moon" data-v-2b76c23f></span><!--]--></span></span></button></div><div class="VPSocialLinks VPNavBarSocialLinks social-links" data-v-d231c45b data-v-584f2254 data-v-91f5f172><!--[--><a class="VPSocialLink no-icon" href="https://github.com/XiaoDaiGua-Ray/ray-template" aria-label="github" target="_blank" rel="noopener" data-v-91f5f172 data-v-976d6037><span class="vpi-social-github"></span></a><!--]--></div><div class="VPFlyout VPNavBarExtra extra" data-v-d231c45b data-v-766dd493 data-v-57202eaf><button type="button" class="button" aria-haspopup="true" aria-expanded="false" aria-label="extra navigation" data-v-57202eaf><span class="vpi-more-horizontal icon" data-v-57202eaf></span></button><div class="menu" data-v-57202eaf><div class="VPMenu" data-v-57202eaf data-v-80746065><!----><!--[--><!--[--><!----><div class="group" data-v-766dd493><div class="item appearance" data-v-766dd493><p class="label" data-v-766dd493>主题</p><div class="appearance-action" data-v-766dd493><button class="VPSwitch VPSwitchAppearance" type="button" role="switch" title aria-checked="false" data-v-766dd493 data-v-2b76c23f data-v-54e91c08><span class="check" data-v-54e91c08><span class="icon" data-v-54e91c08><!--[--><span class="vpi-sun sun" data-v-2b76c23f></span><span class="vpi-moon moon" data-v-2b76c23f></span><!--]--></span></span></button></div></div></div><div class="group" data-v-766dd493><div class="item social-links" data-v-766dd493><div class="VPSocialLinks social-links-list" data-v-766dd493 data-v-91f5f172><!--[--><a class="VPSocialLink no-icon" href="https://github.com/XiaoDaiGua-Ray/ray-template" aria-label="github" target="_blank" rel="noopener" data-v-91f5f172 data-v-976d6037><span class="vpi-social-github"></span></a><!--]--></div></div></div><!--]--><!--]--></div></div></div><!--[--><!--]--><button type="button" class="VPNavBarHamburger hamburger" aria-label="mobile navigation" aria-expanded="false" aria-controls="VPNavScreen" data-v-d231c45b data-v-0ee194e1><span class="container" data-v-0ee194e1><span class="top" data-v-0ee194e1></span><span class="middle" data-v-0ee194e1></span><span class="bottom" data-v-0ee194e1></span></span></button></div></div></div></div><div class="divider" data-v-d231c45b><div class="divider-line" data-v-d231c45b></div></div></div><!----></header><div class="VPLocalNav has-sidebar empty" data-v-f9c03b6e data-v-60478e07><div class="container" data-v-60478e07><button class="menu" aria-expanded="false" aria-controls="VPSidebarNav" data-v-60478e07><span class="vpi-align-left menu-icon" data-v-60478e07></span><span class="menu-text" data-v-60478e07>文档目录</span></button><div class="VPLocalNavOutlineDropdown" style="--vp-vh:0px;" data-v-60478e07 data-v-debc629b><button data-v-debc629b>回到顶部</button><!----></div></div></div><aside class="VPSidebar" data-v-f9c03b6e data-v-efe03c19><div class="curtain" data-v-efe03c19></div><nav class="nav" id="VPSidebarNav" aria-labelledby="sidebar-aria-label" tabindex="-1" data-v-efe03c19><span class="visually-hidden" id="sidebar-aria-label" data-v-efe03c19> Sidebar Navigation </span><!--[--><!--]--><!--[--><div class="no-transition group" data-v-90a0702d><section class="VPSidebarItem level-0" data-v-90a0702d data-v-d34e54b2><!----><div class="items" data-v-d34e54b2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>API 参考总览</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-90a0702d><section class="VPSidebarItem level-0 collapsible collapsed is-link" data-v-90a0702d data-v-d34e54b2><div class="item" tabindex="0" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components.html" data-v-d34e54b2><!--[--><h2 class="text" data-v-d34e54b2>组件</h2><!--]--></a><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-d34e54b2><span class="vpi-chevron-right caret-icon" data-v-d34e54b2></span></div></div><div class="items" data-v-d34e54b2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/table-pro.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>TablePro</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/form.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RForm 与 useForm</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/modal.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RModal</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/chart.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RChart 与 useChart</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/flow.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RFlow 与 useFlow</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/collapse-grid.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RCollapseGrid</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/segment.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RSegment</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/more-dropdown.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RMoreDropdown</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/iframe.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RIframe</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/barcode.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RBarcode</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/draggable-card.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RDraggableCard</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/route-transition.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RTransitionComponent</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/icons.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>RIcon 与 SVG 图标</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/qr-code.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>二维码</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/components/app.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>应用组件与 Provider</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-90a0702d><section class="VPSidebarItem level-0 collapsible collapsed is-link" data-v-90a0702d data-v-d34e54b2><div class="item" tabindex="0" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/hooks.html" data-v-d34e54b2><!--[--><h2 class="text" data-v-d34e54b2>Hooks</h2><!--]--></a><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-d34e54b2><span class="vpi-chevron-right caret-icon" data-v-d34e54b2></span></div></div><div class="items" data-v-d34e54b2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/hooks/navigation.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>导航与菜单</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/hooks/layout.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>布局与滚动</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/hooks/appearance.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>主题、语言和水印</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/hooks/interaction.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>分页与右键菜单</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/hooks/browser.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>窗口、全屏和日期</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/hooks/output.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>DOM 截图与打印</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-90a0702d><section class="VPSidebarItem level-0" data-v-90a0702d data-v-d34e54b2><!----><div class="items" data-v-d34e54b2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/directives.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>指令</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-90a0702d><section class="VPSidebarItem level-0 collapsible collapsed is-link" data-v-90a0702d data-v-d34e54b2><div class="item" tabindex="0" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/store.html" data-v-d34e54b2><!--[--><h2 class="text" data-v-d34e54b2>Store</h2><!--]--></a><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-d34e54b2><span class="vpi-chevron-right caret-icon" data-v-d34e54b2></span></div></div><div class="items" data-v-d34e54b2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/store/setting.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>Setting</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/store/navigation.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>Menu 与 KeepAlive</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/store/runtime.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>Runtime 与 Lock Screen</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/store/signing.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>Signing</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-90a0702d><section class="VPSidebarItem level-0 collapsible collapsed is-link" data-v-90a0702d data-v-d34e54b2><div class="item" tabindex="0" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/utils.html" data-v-d34e54b2><!--[--><h2 class="text" data-v-d34e54b2>工具函数</h2><!--]--></a><div class="caret" role="button" aria-label="toggle section" tabindex="0" data-v-d34e54b2><span class="vpi-chevron-right caret-icon" data-v-d34e54b2></span></div></div><div class="items" data-v-d34e54b2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/utils/core.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>基础、日期和数值</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/utils/storage.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>缓存与兼容加密</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/utils/browser.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>Vue 与浏览器工具</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><div class="no-transition group" data-v-90a0702d><section class="VPSidebarItem level-0 has-active" data-v-90a0702d data-v-d34e54b2><!----><div class="items" data-v-d34e54b2><!--[--><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/configuration.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>应用配置</p><!--]--></a><!----></div><!----></div><div class="VPSidebarItem level-1 is-link" data-v-d34e54b2><div class="item" data-v-d34e54b2><div class="indicator" data-v-d34e54b2></div><a class="VPLink link link" href="/ray-template/docs/reference/source.html" data-v-d34e54b2><!--[--><p class="text" data-v-d34e54b2>文档与源码版本</p><!--]--></a><!----></div><!----></div><!--]--></div></section></div><!--]--><!--[--><!--]--></nav></aside><div class="VPContent has-sidebar" id="VPContent" data-v-f9c03b6e data-v-7ec33352><div class="VPDoc has-sidebar has-aside" data-v-7ec33352 data-v-b0483432><!--[--><!--]--><div class="container" data-v-b0483432><div class="aside" data-v-b0483432><div class="aside-curtain" data-v-b0483432></div><div class="aside-container" data-v-b0483432><div class="aside-content" data-v-b0483432><div class="VPDocAside" data-v-b0483432 data-v-6d31e1a2><!--[--><!--]--><!--[--><!--]--><nav aria-labelledby="doc-outline-aria-label" class="VPDocAsideOutline" data-v-6d31e1a2 data-v-a849a091><div class="content" data-v-a849a091><div class="outline-marker" data-v-a849a091></div><div aria-level="2" class="outline-title" id="doc-outline-aria-label" role="heading" data-v-a849a091>本页目录</div><ul class="VPDocOutlineItem root" data-v-a849a091 data-v-78a615b5><!--[--><!--]--></ul></div></nav><!--[--><!--]--><div class="spacer" data-v-6d31e1a2></div><!--[--><!--]--><!----><!--[--><!--]--><!--[--><!--]--></div></div></div></div><div class="content" data-v-b0483432><div class="content-container" data-v-b0483432><!--[--><!--[--><!--[--><div class="ray-doc-meta"><span>参考</span><a href="/ray-template/docs/reference/source.html">版本 <code>6.0.0</code></a></div><!--]--><!--]--><!--]--><main class="main" data-v-b0483432><div style="position:relative;" class="vp-doc _ray-template_docs_reference_configuration" data-v-b0483432><div><h1 id="应用配置" tabindex="-1">应用配置 <a class="header-anchor" href="#应用配置" aria-label="Permalink to &quot;应用配置&quot;">​</a></h1><p>应用配置与站外文档配置分属两个仓库。这里说明 Ray Template 应用中的 <code>@/app-config</code>、Vite 配置和运行期设置。运行期保存的用户偏好可能覆盖源码默认值,验证默认设置时使用干净的浏览器存储。</p><table tabindex="0"><thead><tr><th>文件</th><th>配置</th></tr></thead><tbody><tr><td><code>apps/admin/src/app-config/app-config.ts</code></td><td><code>GLOBAL_CLASS_NAMES</code>(明暗类与 CSS 变量)、<code>MESSAGE_PROVIDER</code>(上下文消息,默认最多 5 条、不可关闭)、<code>LAYOUT_CONTENT_SPIN_WHEN_ROUTE_CHANGE</code>(默认关)、<code>APP_GLOBAL_LOADING</code>、<code>PRE_LOADING_CONFIG</code>、<code>APP_CATCH_KEY</code> / <code>APP_CATCH_KEY_PREFIX</code>、<code>CONTENT_TRANSITION_OPTIONS</code>。</td></tr><tr><td><code>apps/admin/src/app-config/design-config.ts</code></td><td><code>APP_THEME</code> 的候选色、默认蓝 <code>#3b63d9</code>、Naive UI 明暗覆盖、ECharts 默认主题。</td></tr><tr><td><code>apps/admin/src/app-config/local-config.ts</code></td><td><code>LOCAL_OPTIONS</code>、<code>SYSTEM_DEFAULT_LOCAL</code>、<code>SYSTEM_FALLBACK_LOCALE</code>、<code>DAYJS_LOCAL_MAP</code>、<code>DEFAULT_DAYJS_LOCAL</code>。默认与回退语言为 <code>zh-CN</code>。</td></tr><tr><td><code>apps/admin/src/app-config/request-config.ts</code></td><td><code>AXIOS_CONFIG</code>。默认同源相对地址、5 秒超时、<code>withCredentials: false</code>、JSON Content-Type。</td></tr><tr><td><code>apps/admin/src/app-config/router-config.ts</code></td><td><code>SETUP_ROUTER_ACTION</code>(加载条与守卫默认开)、<code>WHITE_ROUTES</code>(路由名白名单)、<code>SUPER_ADMIN</code>(默认空)、<code>LAYOUT_CONTENT_REF</code> / <code>LAYOUT_SIDER_REF</code>。</td></tr><tr><td><code>apps/admin/src/app-config/regex-config.ts</code></td><td><code>APP_REGEX</code>,模板 CSS 尺寸规则。</td></tr><tr><td><code>vite.custom.config.ts</code></td><td><code>base</code>、<code>server</code>、<code>buildOptions(mode)</code>、<code>alias</code>、<code>cdn</code>、<code>copyright</code>、Sass 注入和首屏加载配置。</td></tr></tbody></table><h2 id="选择改动入口" tabindex="-1">选择改动入口 <a class="header-anchor" href="#选择改动入口" aria-label="Permalink to &quot;选择改动入口&quot;">​</a></h2><ul><li>修改默认用户偏好(布局、菜单、标签、缓存)时看 <a href="./store/setting.html">Setting Store</a> 与 <code>apps/admin/src/store/modules/setting/constant.ts</code>。已有用户可在应用设置里恢复默认后检查效果。</li><li>修改主题或语言时看<a href="./../guide/appearance.html">主题和国际化</a>。新增语言同时维护翻译资源与 Day.js、Naive UI 对应关系。</li><li>修改访问控制时看<a href="./../guide/routing.html">路由指南</a>。白名单按区分大小写的字符串路由名判断,守卫先处理 token,再按白名单和角色处理导航。</li><li>修改 API 地址、认证头和失败策略时看<a href="./../guide/requests.html">接口与 Mock</a>。应用不会自动把任意 <code>VITE_*</code> 环境变量绑定到 Axios;需在配置中明确读取。</li><li>应用默认部署子路径 <code>/ray-template/</code>。部署子路径改变后重新构建并验证图标、代理和直达链接,见<a href="./../guide/tooling.html">工程与部署</a>。</li></ul><p><code>__APP_CFG__</code> 由 Vite 在构建时注入,用于应用包信息、版权与默认主色。任何注入到客户端的字段都可被浏览器读取。用于页面交互的运行态偏好走 Store,构建参数留在 Vite 配置。</p><p><a href="https://github.com/XiaoDaiGua-Ray/ray-template/tree/40320207ac6649076457fdcf33fbe04181d6288a/apps/admin/src/app-config" target="_blank" rel="noreferrer">应用配置源码</a> · <a href="https://github.com/XiaoDaiGua-Ray/ray-template/blob/40320207ac6649076457fdcf33fbe04181d6288a/vite.custom.config.ts" target="_blank" rel="noreferrer">Vite 自定义配置</a></p></div></div></main><footer class="VPDocFooter" data-v-b0483432 data-v-028296d9><!--[--><!--]--><!----><nav class="prev-next" aria-labelledby="doc-footer-aria-label" data-v-028296d9><span class="visually-hidden" id="doc-footer-aria-label" data-v-028296d9>Pager</span><div class="pager" data-v-028296d9><a class="VPLink link pager-link prev" href="/ray-template/docs/reference/utils/browser.html" data-v-028296d9><!--[--><span class="desc" data-v-028296d9>上一页</span><span class="title" data-v-028296d9>Vue 与浏览器工具</span><!--]--></a></div><div class="pager" data-v-028296d9><a class="VPLink link pager-link next" href="/ray-template/docs/reference/source.html" data-v-028296d9><!--[--><span class="desc" data-v-028296d9>下一页</span><span class="title" data-v-028296d9>文档与源码版本</span><!--]--></a></div></nav></footer><!--[--><!--]--></div></div></div><!--[--><!--]--></div></div><footer class="VPFooter has-sidebar" data-v-f9c03b6e data-v-20a32aa3><div class="container" data-v-20a32aa3><!----><p class="copyright" data-v-20a32aa3>© 2022–至今 Ray · MIT License</p></div></footer><!--[--><!--]--></div></div>
<script>window.__VP_HASH_MAP__=JSON.parse("{\"guide_appearance.md\":\"C8lLh6B_\",\"guide_architecture.md\":\"BoValk6V\",\"guide_first-page.md\":\"DQyAN9wP\",\"guide_layout.md\":\"xv3GaGTF\",\"guide_requests.md\":\"moE359gT\",\"guide_routing.md\":\"Bwh8q-uS\",\"guide_start.md\":\"BItN50dZ\",\"guide_tooling.md\":\"ByzxKwPK\",\"index.md\":\"BoXFYNIY\",\"migration.md\":\"Bz5cCL-0\",\"playground_shell.md\":\"DolcWu2f\",\"reference_components.md\":\"BOnfdEB5\",\"reference_components_app.md\":\"BT8hcciS\",\"reference_components_barcode.md\":\"91K3Dvi4\",\"reference_components_chart.md\":\"DCiJLK6L\",\"reference_components_collapse-grid.md\":\"DaNzIm7f\",\"reference_components_draggable-card.md\":\"Tq0TQDvP\",\"reference_components_flow.md\":\"BMYIbX5Q\",\"reference_components_form.md\":\"DHBQEQ7I\",\"reference_components_iframe.md\":\"BQLU9ghY\",\"reference_components_modal.md\":\"Df53DB-p\",\"reference_components_more-dropdown.md\":\"NJsR4V5U\",\"reference_components_qr-code.md\":\"D_DsapkT\",\"reference_components_route-transition.md\":\"DXBsiYSm\",\"reference_components_segment.md\":\"CjhQpVM9\",\"reference_configuration.md\":\"BCh89HnV\",\"reference_directives.md\":\"Dd95iCBF\",\"reference_hooks.md\":\"B26GkSoK\",\"reference_hooks_appearance.md\":\"Bcm9lXhn\",\"reference_hooks_browser.md\":\"B2JvlRwE\",\"reference_hooks_interaction.md\":\"CVNFClRV\",\"reference_hooks_layout.md\":\"BMGSDLmM\",\"reference_hooks_navigation.md\":\"CI1Ww7h_\",\"reference_hooks_output.md\":\"C1UQw1E3\",\"reference_icons.md\":\"DdPayfJ2\",\"reference_index.md\":\"BMzkEQQ1\",\"reference_source.md\":\"Bp8wG02v\",\"reference_store.md\":\"DQxDhBCf\",\"reference_store_navigation.md\":\"Ba0a4EI1\",\"reference_store_runtime.md\":\"n8A5463C\",\"reference_store_setting.md\":\"BHiWF4im\",\"reference_store_signing.md\":\"Dl1JCNnH\",\"reference_table-pro.md\":\"-Znx76lL\",\"reference_utils.md\":\"CjCZ4g7_\",\"reference_utils_browser.md\":\"Bti5_Cyy\",\"reference_utils_core.md\":\"14iof--l\",\"reference_utils_storage.md\":\"DkRuZi2B\"}");window.__VP_SITE_DATA__=JSON.parse("{\"lang\":\"zh-CN\",\"dir\":\"ltr\",\"title\":\"Ray Template\",\"titleTemplate\":\":title · Ray Template 文档\",\"description\":\"Ray Template 6.0.0 的 Monorepo 架构、版本分界、组件与交互示例。\",\"base\":\"/ray-template/docs/\",\"head\":[],\"router\":{\"prefetchLinks\":true},\"appearance\":true,\"themeConfig\":{\"logo\":{\"src\":\"/ray-mark.svg\",\"alt\":\"\"},\"siteTitle\":\"Ray Template\",\"nav\":[{\"text\":\"指南\",\"link\":\"/guide/start\",\"activeMatch\":\"^/guide/\"},{\"text\":\"架构\",\"link\":\"/guide/architecture\"},{\"text\":\"版本分界\",\"link\":\"/migration\"},{\"text\":\"API 参考\",\"link\":\"/reference/\",\"activeMatch\":\"^/reference/\"},{\"text\":\"Ray Admin\",\"link\":\"https://xiaodaigua-ray.github.io/ray-template/\"}],\"sidebar\":{\"/reference/\":[{\"text\":\"API 参考总览\",\"link\":\"/reference/\"},{\"text\":\"组件\",\"link\":\"/reference/components\",\"collapsed\":true,\"items\":[{\"text\":\"TablePro\",\"link\":\"/reference/table-pro\"},{\"text\":\"RForm 与 useForm\",\"link\":\"/reference/components/form\"},{\"text\":\"RModal\",\"link\":\"/reference/components/modal\"},{\"text\":\"RChart 与 useChart\",\"link\":\"/reference/components/chart\"},{\"text\":\"RFlow 与 useFlow\",\"link\":\"/reference/components/flow\"},{\"text\":\"RCollapseGrid\",\"link\":\"/reference/components/collapse-grid\"},{\"text\":\"RSegment\",\"link\":\"/reference/components/segment\"},{\"text\":\"RMoreDropdown\",\"link\":\"/reference/components/more-dropdown\"},{\"text\":\"RIframe\",\"link\":\"/reference/components/iframe\"},{\"text\":\"RBarcode\",\"link\":\"/reference/components/barcode\"},{\"text\":\"RDraggableCard\",\"link\":\"/reference/components/draggable-card\"},{\"text\":\"RTransitionComponent\",\"link\":\"/reference/components/route-transition\"},{\"text\":\"RIcon 与 SVG 图标\",\"link\":\"/reference/icons\"},{\"text\":\"二维码\",\"link\":\"/reference/components/qr-code\"},{\"text\":\"应用组件与 Provider\",\"link\":\"/reference/components/app\"}]},{\"text\":\"Hooks\",\"link\":\"/reference/hooks\",\"collapsed\":true,\"items\":[{\"text\":\"导航与菜单\",\"link\":\"/reference/hooks/navigation\"},{\"text\":\"布局与滚动\",\"link\":\"/reference/hooks/layout\"},{\"text\":\"主题、语言和水印\",\"link\":\"/reference/hooks/appearance\"},{\"text\":\"分页与右键菜单\",\"link\":\"/reference/hooks/interaction\"},{\"text\":\"窗口、全屏和日期\",\"link\":\"/reference/hooks/browser\"},{\"text\":\"DOM 截图与打印\",\"link\":\"/reference/hooks/output\"}]},{\"text\":\"指令\",\"link\":\"/reference/directives\"},{\"text\":\"Store\",\"link\":\"/reference/store\",\"collapsed\":true,\"items\":[{\"text\":\"Setting\",\"link\":\"/reference/store/setting\"},{\"text\":\"Menu 与 KeepAlive\",\"link\":\"/reference/store/navigation\"},{\"text\":\"Runtime 与 Lock Screen\",\"link\":\"/reference/store/runtime\"},{\"text\":\"Signing\",\"link\":\"/reference/store/signing\"}]},{\"text\":\"工具函数\",\"link\":\"/reference/utils\",\"collapsed\":true,\"items\":[{\"text\":\"基础、日期和数值\",\"link\":\"/reference/utils/core\"},{\"text\":\"缓存与兼容加密\",\"link\":\"/reference/utils/storage\"},{\"text\":\"Vue 与浏览器工具\",\"link\":\"/reference/utils/browser\"}]},{\"text\":\"应用配置\",\"link\":\"/reference/configuration\"},{\"text\":\"文档与源码版本\",\"link\":\"/reference/source\"}],\"/\":[{\"text\":\"入门\",\"items\":[{\"text\":\"快速开始\",\"link\":\"/guide/start\"},{\"text\":\"v6 Monorepo 架构\",\"link\":\"/guide/architecture\"},{\"text\":\"v5 与 v6 的版本分界\",\"link\":\"/migration\"},{\"text\":\"第一个业务页面\",\"link\":\"/guide/first-page\"}]},{\"text\":\"开发指南\",\"items\":[{\"text\":\"路由、菜单与权限\",\"link\":\"/guide/routing\"},{\"text\":\"应用布局与状态\",\"link\":\"/guide/layout\"},{\"text\":\"接口、取消与 Mock\",\"link\":\"/guide/requests\"},{\"text\":\"主题与国际化\",\"link\":\"/guide/appearance\"},{\"text\":\"工程检查与部署\",\"link\":\"/guide/tooling\"}]},{\"text\":\"API 参考\",\"link\":\"/reference/\"}]},\"outline\":{\"label\":\"本页目录\",\"level\":[2,3]},\"search\":{\"provider\":\"local\",\"options\":{\"translations\":{\"button\":{\"buttonText\":\"搜索文档\",\"buttonAriaLabel\":\"搜索文档\"},\"modal\":{\"noResultsText\":\"未找到相关内容\",\"resetButtonTitle\":\"清除搜索\",\"footer\":{\"selectText\":\"打开\",\"navigateText\":\"切换\",\"closeText\":\"关闭\"}}}}},\"skipToContentLabel\":\"跳转到正文\",\"docFooter\":{\"prev\":\"上一页\",\"next\":\"下一页\"},\"returnToTopLabel\":\"回到顶部\",\"sidebarMenuLabel\":\"文档目录\",\"darkModeSwitchLabel\":\"主题\",\"lightModeSwitchTitle\":\"切换到浅色\",\"darkModeSwitchTitle\":\"切换到深色\",\"socialLinks\":[{\"icon\":\"github\",\"link\":\"https://github.com/XiaoDaiGua-Ray/ray-template\"}],\"footer\":{\"copyright\":\"© 2022–至今 Ray · MIT License\"}},\"locales\":{},\"scrollOffset\":134,\"cleanUrls\":false}");</script>
</body>
</html>