[{"data":1,"prerenderedAt":617},["ShallowReactive",2],{"content:\u002Funh\u002Fenv":3,"section:unh":597},{"id":4,"title":5,"aside":6,"authors":7,"badges":8,"banner":7,"body":17,"breadcrumb":6,"collapse":588,"description":589,"editLink":6,"extension":590,"fullpage":588,"header":7,"icon":591,"main":7,"meta":592,"navBadges":7,"navTruncate":588,"navigation":7,"path":593,"prevNext":6,"seo":594,"stem":595,"toc":6,"__hash__":596},"content\u002Funh\u002F6.env.md","环境变量配置",true,null,[9,13],{"value":10,"to":11,"target":12},"npm","https:\u002F\u002Fwww.npmjs.com\u002Fpackage\u002F@uni-helper\u002Funh","_blank",{"value":14,"icon":15,"to":16,"target":12},"source","lucide:code","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Funh",{"type":18,"value":19,"toc":574},"minimark",[20,28,32,132,283,286,292,316,340,347,372,375,378,387,389,395,398,407,409,418,422,433,436,448,451,462,468,471,474,477,483,489,570],[21,22,23,27],"p",{},[24,25,26],"code",{},"env"," 按当前平台与模式提前加载环境变量，并生成类型声明文件。",[29,30,31],"h2",{"id":31},"配置",[33,34,40],"pre",{"className":35,"code":36,"filename":37,"language":38,"meta":39,"style":39},"language-ts shiki shiki-themes material-theme-lighter material-theme material-theme-palenight","import { defineConfig } from '@uni-helper\u002Funh'\n\nexport default defineConfig({\n  \u002F\u002F 用默认配置开启\n  env: true,\n})\n","unh.config.ts","ts","",[24,41,42,75,81,99,106,123],{"__ignoreMap":39},[43,44,47,51,55,59,62,65,68,72],"span",{"class":45,"line":46},"line",1,[43,48,50],{"class":49},"s7zQu","import",[43,52,54],{"class":53},"sMK4o"," {",[43,56,58],{"class":57},"sTEyZ"," defineConfig",[43,60,61],{"class":53}," }",[43,63,64],{"class":49}," from",[43,66,67],{"class":53}," '",[43,69,71],{"class":70},"sfazB","@uni-helper\u002Funh",[43,73,74],{"class":53},"'\n",[43,76,78],{"class":45,"line":77},2,[43,79,80],{"emptyLinePlaceholder":6},"\n",[43,82,84,87,90,93,96],{"class":45,"line":83},3,[43,85,86],{"class":49},"export",[43,88,89],{"class":49}," default",[43,91,58],{"class":92},"s2Zo4",[43,94,95],{"class":57},"(",[43,97,98],{"class":53},"{\n",[43,100,102],{"class":45,"line":101},4,[43,103,105],{"class":104},"sHwdD","  \u002F\u002F 用默认配置开启\n",[43,107,109,113,116,120],{"class":45,"line":108},5,[43,110,112],{"class":111},"swJcz","  env",[43,114,115],{"class":53},":",[43,117,119],{"class":118},"sfNiH"," true",[43,121,122],{"class":53},",\n",[43,124,126,129],{"class":45,"line":125},6,[43,127,128],{"class":53},"}",[43,130,131],{"class":57},")\n",[33,133,135],{"className":35,"code":134,"filename":37,"language":38,"meta":39,"style":39},"import { defineConfig } from '@uni-helper\u002Funh'\n\nexport default defineConfig({\n  env: {\n    root: 'envs',\n    usePlatformDir: true,\n    prefixes: ['VITE_', 'UNI_'],\n    intoProcess: true,\n    dts: 'uni-env.d.ts',\n  },\n})\n",[24,136,137,155,159,171,180,197,208,241,253,270,276],{"__ignoreMap":39},[43,138,139,141,143,145,147,149,151,153],{"class":45,"line":46},[43,140,50],{"class":49},[43,142,54],{"class":53},[43,144,58],{"class":57},[43,146,61],{"class":53},[43,148,64],{"class":49},[43,150,67],{"class":53},[43,152,71],{"class":70},[43,154,74],{"class":53},[43,156,157],{"class":45,"line":77},[43,158,80],{"emptyLinePlaceholder":6},[43,160,161,163,165,167,169],{"class":45,"line":83},[43,162,86],{"class":49},[43,164,89],{"class":49},[43,166,58],{"class":92},[43,168,95],{"class":57},[43,170,98],{"class":53},[43,172,173,175,177],{"class":45,"line":101},[43,174,112],{"class":111},[43,176,115],{"class":53},[43,178,179],{"class":53}," {\n",[43,181,182,185,187,189,192,195],{"class":45,"line":108},[43,183,184],{"class":111},"    root",[43,186,115],{"class":53},[43,188,67],{"class":53},[43,190,191],{"class":70},"envs",[43,193,194],{"class":53},"'",[43,196,122],{"class":53},[43,198,199,202,204,206],{"class":45,"line":125},[43,200,201],{"class":111},"    usePlatformDir",[43,203,115],{"class":53},[43,205,119],{"class":118},[43,207,122],{"class":53},[43,209,211,214,216,219,221,224,226,229,231,234,236,239],{"class":45,"line":210},7,[43,212,213],{"class":111},"    prefixes",[43,215,115],{"class":53},[43,217,218],{"class":57}," [",[43,220,194],{"class":53},[43,222,223],{"class":70},"VITE_",[43,225,194],{"class":53},[43,227,228],{"class":53},",",[43,230,67],{"class":53},[43,232,233],{"class":70},"UNI_",[43,235,194],{"class":53},[43,237,238],{"class":57},"]",[43,240,122],{"class":53},[43,242,244,247,249,251],{"class":45,"line":243},8,[43,245,246],{"class":111},"    intoProcess",[43,248,115],{"class":53},[43,250,119],{"class":118},[43,252,122],{"class":53},[43,254,256,259,261,263,266,268],{"class":45,"line":255},9,[43,257,258],{"class":111},"    dts",[43,260,115],{"class":53},[43,262,67],{"class":53},[43,264,265],{"class":70},"uni-env.d.ts",[43,267,194],{"class":53},[43,269,122],{"class":53},[43,271,273],{"class":45,"line":272},10,[43,274,275],{"class":53},"  },\n",[43,277,279,281],{"class":45,"line":278},11,[43,280,128],{"class":53},[43,282,131],{"class":57},[29,284,285],{"id":285},"加载哪些文件",[21,287,288,291],{},[24,289,290],{},"unh"," 按以下顺序读取文件，后读的覆盖先读的：",[293,294,295,301,306,311],"ol",{},[296,297,298],"li",{},[24,299,300],{},".env",[296,302,303],{},[24,304,305],{},".env.local",[296,307,308],{},[24,309,310],{},".env.{mode}",[296,312,313],{},[24,314,315],{},".env.{mode}.local",[21,317,318,321,322,325,326,321,329,331,332,335,336,339],{},[24,319,320],{},"usePlatformDir"," 为 ",[24,323,324],{},"true"," 时，文件放在平台名子目录下。例如 ",[24,327,328],{},"root",[24,330,191],{}," 时，路径是 ",[24,333,334],{},"envs\u002Fmp-weixin\u002F.env","、",[24,337,338],{},"envs\u002Fh5\u002F.env","。",[21,341,342,343,346],{},"只有匹配 ",[24,344,345],{},"prefixes"," 的变量会被加载。",[348,349,351,364],"alert",{"type":350},"warning",[21,352,353,356,357,360,361,363],{},[24,354,355],{},"mode"," 不能写成 ",[24,358,359],{},"local","。写成 ",[24,362,359],{}," 时直接抛错：",[33,365,370],{"className":366,"code":368,"language":369,"meta":39},[367],"language-text","\"Local\" cannot be used as a mode.\n","text",[24,371,368],{"__ignoreMap":39},[29,373,374],{"id":374},"配置项",[376,377,26],"h3",{"id":26},[379,380,382],"field",{"name":26,"type":381},"true | EnvConfig",[21,383,384,386],{},[24,385,324],{}," 用默认配置开启，对象形式逐项配置。默认不开启。",[376,388,328],{"id":328},[379,390,392],{"name":328,"type":391},"string",[21,393,394],{},"环境变量文件的根目录。默认是项目根目录。",[376,396,320],{"id":397},"useplatformdir",[379,399,401],{"name":320,"type":400},"boolean",[21,402,403,404,339],{},"是否用平台名当子目录。默认值 ",[24,405,406],{},"false",[376,408,345],{"id":345},[379,410,412],{"name":345,"type":411},"string[]",[21,413,414,415,339],{},"只加载这些前缀开头的变量。默认值 ",[24,416,417],{},"['VITE_', 'UNI_']",[376,419,421],{"id":420},"intoprocess","intoProcess",[379,423,424],{"name":421,"type":400},[21,425,426,427,430,431,339],{},"是否把加载的变量合并进 ",[24,428,429],{},"process.env","。默认值 ",[24,432,324],{},[376,434,435],{"id":435},"dts",[379,437,439],{"name":435,"type":438},"false | string",[21,440,441,442,444,445,339],{},"类型声明文件的路径。",[24,443,406],{}," 不生成。默认值 ",[24,446,447],{},"'uni-env.d.ts'",[29,449,450],{"id":450},"生成类型声明",[21,452,453,455,456,458,459,461],{},[24,454,435],{}," 不为 ",[24,457,406],{}," 时，",[24,460,290],{}," 生成一个声明文件，内容形如：",[33,463,466],{"className":464,"code":465,"filename":265,"language":369,"meta":39},[367],"\u002F\u002F\u002F \u003Creference types=\"vite\u002Fclient\" \u002F>\ninterface ImportMetaEnv {\n  \u002F** 环境变量 *\u002F\n  readonly VITE_API_BASE_URL: string;\n}\n",[24,467,465],{"__ignoreMap":39},[21,469,470],{},"变量名来自实际加载到的环境变量，不要手改这个文件。",[29,472,473],{"id":473},"示例",[21,475,476],{},"按平台放不同的接口地址：",[33,478,481],{"className":479,"code":480,"language":369,"meta":39},[367],"envs\u002F\n  h5\u002F.env\n  mp-weixin\u002F.env\n",[24,482,480],{"__ignoreMap":39},[33,484,487],{"className":485,"code":486,"filename":334,"language":369,"meta":39},[367],"VITE_API_BASE_URL=https:\u002F\u002Fmp.example.com\n",[24,488,486],{"__ignoreMap":39},[33,490,492],{"className":35,"code":491,"filename":37,"language":38,"meta":39,"style":39},"import { defineConfig } from '@uni-helper\u002Funh'\n\nexport default defineConfig({\n  env: {\n    root: 'envs',\n    usePlatformDir: true,\n  },\n})\n",[24,493,494,512,516,528,536,550,560,564],{"__ignoreMap":39},[43,495,496,498,500,502,504,506,508,510],{"class":45,"line":46},[43,497,50],{"class":49},[43,499,54],{"class":53},[43,501,58],{"class":57},[43,503,61],{"class":53},[43,505,64],{"class":49},[43,507,67],{"class":53},[43,509,71],{"class":70},[43,511,74],{"class":53},[43,513,514],{"class":45,"line":77},[43,515,80],{"emptyLinePlaceholder":6},[43,517,518,520,522,524,526],{"class":45,"line":83},[43,519,86],{"class":49},[43,521,89],{"class":49},[43,523,58],{"class":92},[43,525,95],{"class":57},[43,527,98],{"class":53},[43,529,530,532,534],{"class":45,"line":101},[43,531,112],{"class":111},[43,533,115],{"class":53},[43,535,179],{"class":53},[43,537,538,540,542,544,546,548],{"class":45,"line":108},[43,539,184],{"class":111},[43,541,115],{"class":53},[43,543,67],{"class":53},[43,545,191],{"class":70},[43,547,194],{"class":53},[43,549,122],{"class":53},[43,551,552,554,556,558],{"class":45,"line":125},[43,553,201],{"class":111},[43,555,115],{"class":53},[43,557,119],{"class":118},[43,559,122],{"class":53},[43,561,562],{"class":45,"line":210},[43,563,275],{"class":53},[43,565,566,568],{"class":45,"line":243},[43,567,128],{"class":53},[43,569,131],{"class":57},[571,572,573],"style",{},"html pre.shiki code .s7zQu, html code.shiki .s7zQu{--shiki-light:#39ADB5;--shiki-light-font-style:italic;--shiki-default:#89DDFF;--shiki-default-font-style:italic;--shiki-dark:#89DDFF;--shiki-dark-font-style:italic}html pre.shiki code .sMK4o, html code.shiki .sMK4o{--shiki-light:#39ADB5;--shiki-default:#89DDFF;--shiki-dark:#89DDFF}html pre.shiki code .sTEyZ, html code.shiki .sTEyZ{--shiki-light:#90A4AE;--shiki-default:#EEFFFF;--shiki-dark:#BABED8}html pre.shiki code .sfazB, html code.shiki .sfazB{--shiki-light:#91B859;--shiki-default:#C3E88D;--shiki-dark:#C3E88D}html pre.shiki code .s2Zo4, html code.shiki .s2Zo4{--shiki-light:#6182B8;--shiki-default:#82AAFF;--shiki-dark:#82AAFF}html pre.shiki code .sHwdD, html code.shiki .sHwdD{--shiki-light:#90A4AE;--shiki-light-font-style:italic;--shiki-default:#546E7A;--shiki-default-font-style:italic;--shiki-dark:#676E95;--shiki-dark-font-style:italic}html pre.shiki code .swJcz, html code.shiki .swJcz{--shiki-light:#E53935;--shiki-default:#F07178;--shiki-dark:#F07178}html pre.shiki code .sfNiH, html code.shiki .sfNiH{--shiki-light:#FF5370;--shiki-default:#FF9CAC;--shiki-dark:#FF9CAC}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}",{"title":39,"searchDepth":77,"depth":77,"links":575},[576,577,578,586,587],{"id":31,"depth":77,"text":31},{"id":285,"depth":77,"text":285},{"id":374,"depth":77,"text":374,"children":579},[580,581,582,583,584,585],{"id":26,"depth":83,"text":26},{"id":328,"depth":83,"text":328},{"id":397,"depth":83,"text":320},{"id":345,"depth":83,"text":345},{"id":420,"depth":83,"text":421},{"id":435,"depth":83,"text":435},{"id":450,"depth":77,"text":450},{"id":473,"depth":77,"text":473},false,"根据当前编译平台及模式提前加载对应的环境变量并生成类型声明文件","md","lucide:chevrons-left-right-ellipsis",{},"\u002Funh\u002Fenv",{"title":5,"description":589},"unh\u002F6.env","ziYnHy1XeqgGq_sGzC_mr4iG_HtusuvMUNksI6F-SCE",{"id":598,"title":290,"aside":6,"authors":7,"badges":7,"banner":7,"body":7,"breadcrumb":6,"collapse":588,"description":599,"editLink":6,"extension":600,"fullpage":588,"header":7,"icon":7,"main":7,"meta":601,"navBadges":7,"navTruncate":588,"navigation":602,"path":604,"prevNext":6,"seo":605,"stem":606,"toc":607,"__hash__":616},"content\u002Funh\u002F_dir.yml","二次封装的启动命令，支持平台别名和自定义Hooks","yml",{"showTitle":588},{"redirect":603},"\u002Funh\u002Finstallation","\u002Funh\u002F_dir",{"title":290,"description":599},"unh\u002F_dir",{"links":608},[609,612],{"title":610,"icon":611,"to":16,"target":12},"点亮星星","lucide:star",{"title":613,"icon":614,"to":615,"target":12},"反馈问题","lucide:github","https:\u002F\u002Fgithub.com\u002Funi-helper\u002Funh\u002Fissues","slDJxNvC8rO7mMtnt8-RsLXtYaZ0Eo-GZYY42hNl-8A",1795164923673]