@zfqh/uview-x 0.0.3 → 0.0.5

package/styles/common.scss

@@ -1,134 +1,148 @@
-// 全局工具类（x-safe）。
-//
-// App 蒸汽模式只支持 class / 分组 / 复合 class / page 选择器，
-// 因此这里不使用元素选择器、伪类、伪元素；Web/小程序专属规则放在条件块中。
-
-// 超出行数，自动显示行尾省略号，最多 5 行
-// App 蒸汽模式用 text 的 max-lines；nvue 用 weex 的 lines；Web/小程序用 CSS 截断。
-/* #ifdef APP-NVUE */
-@for $i from 1 through 5 {
-	.uv-line-#{$i} {
-		lines: $i;
-		text-overflow: ellipsis;
-		overflow: hidden;
-		flex: 1;
-	}
-}
-/* #endif */
-
-/* #ifdef WEB || H5 || MP */
-@for $i from 1 through 5 {
-	.uv-line-#{$i} {
-		@if $i == 1 {
-			overflow: hidden;
-			white-space: nowrap;
-			text-overflow: ellipsis;
-		} @else {
-			display: -webkit-box !important;
-			overflow: hidden;
-			text-overflow: ellipsis;
-			word-break: break-all;
-			-webkit-line-clamp: $i;
-			-webkit-box-orient: vertical !important;
-		}
-	}
-}
-/* #endif */
-
-$uv-bordercolor: #dadbde !default;
-@if variable-exists(uv-border-color) {
-	$uv-bordercolor: $uv-border-color;
-}
-
-// 边框工具类：
-// - nvue 不支持 !important，基础声明供 App-NVUE 使用；
-// - Web/H5/MP 与 App 蒸汽模式保留 !important 覆盖组件内联边框（与上游行为一致）。
-.uv-border {
-	border-style: solid;
-	border-width: 0.5px;
-	border-color: $uv-bordercolor;
-	/* #ifndef APP-NVUE */
-	border-width: 0.5px !important;
-	border-color: $uv-bordercolor !important;
-	/* #endif */
-}
-
-.uv-border-top {
-	border-top-style: solid;
-	border-top-width: 0.5px;
-	border-color: $uv-bordercolor;
-	/* #ifndef APP-NVUE */
-	border-top-width: 0.5px !important;
-	border-color: $uv-bordercolor !important;
-	/* #endif */
-}
-
-.uv-border-left {
-	border-left-style: solid;
-	border-left-width: 0.5px;
-	border-color: $uv-bordercolor;
-	/* #ifndef APP-NVUE */
-	border-left-width: 0.5px !important;
-	border-color: $uv-bordercolor !important;
-	/* #endif */
-}
-
-.uv-border-right {
-	border-right-style: solid;
-	border-right-width: 0.5px;
-	border-color: $uv-bordercolor;
-	/* #ifndef APP-NVUE */
-	border-right-width: 0.5px !important;
-	border-color: $uv-bordercolor !important;
-	/* #endif */
-}
-
-.uv-border-bottom {
-	border-bottom-style: solid;
-	border-bottom-width: 0.5px;
-	border-color: $uv-bordercolor;
-	/* #ifndef APP-NVUE */
-	border-bottom-width: 0.5px !important;
-	border-color: $uv-bordercolor !important;
-	/* #endif */
-}
-
-.uv-border-top-bottom {
-	border-top-style: solid;
-	border-bottom-style: solid;
-	border-top-width: 0.5px;
-	border-bottom-width: 0.5px;
-	border-color: $uv-bordercolor;
-	/* #ifndef APP-NVUE */
-	border-top-width: 0.5px !important;
-	border-bottom-width: 0.5px !important;
-	border-color: $uv-bordercolor !important;
-	/* #endif */
-}
-
-// 去除 button 默认样式，让其表现跟普通 view/text 一致
-// 注意：App 蒸汽模式不支持 font-size/line-height/color: inherit，这里给显式兜底值，
-// 组件内部会通过内联样式/局部 class 覆盖。
-.uv-reset-button {
-	padding: 0;
-	background-color: transparent;
-	/* #ifndef APP-NVUE */
-	border-width: 0;
-	font-size: 16px;
-	line-height: 20px;
-	color: #303133;
-	/* #endif */
-	/* #ifdef APP-NVUE */
-	border-width: 0;
-	/* #endif */
-}
-
-/* #ifdef WEB || H5 || MP */
-.uv-reset-button::after {
-	border: none;
-}
-/* #endif */
-
-.uv-hover-class {
-	opacity: 0.7;
-}
+// 全局工具类（x-safe）：行数截断、边框、button 重置、hover 与安全区/H5 辅助规则。
+//
+// App 蒸汽模式只支持 class / 分组 / 复合 class / page 选择器，
+// 因此这里不使用元素选择器、伪类、伪元素；Web/小程序专属规则放在条件块中。
+//
+// 主题变量由 theme.scss 提供（!default）：单独引入本文件时也能取到 $uv-*；
+// 项目通过 uni.scss 覆盖同名变量时不会被这里覆盖。
+
+@import './theme.scss';
+
+// 超出行数，自动显示行尾省略号，最多 5 行
+// App 蒸汽模式用 text 的 max-lines；nvue 用 weex 的 lines；Web/小程序用 CSS 截断。
+/* #ifdef APP-NVUE */
+@for $i from 1 through 5 {
+	.uv-line-#{$i} {
+		lines: $i;
+		text-overflow: ellipsis;
+		overflow: hidden;
+		flex: 1;
+	}
+}
+/* #endif */
+
+/* #ifdef WEB || H5 || MP */
+@for $i from 1 through 5 {
+	.uv-line-#{$i} {
+		@if $i == 1 {
+			overflow: hidden;
+			white-space: nowrap;
+			text-overflow: ellipsis;
+		} @else {
+			display: -webkit-box !important;
+			overflow: hidden;
+			text-overflow: ellipsis;
+			word-break: break-all;
+			-webkit-line-clamp: $i;
+			-webkit-box-orient: vertical !important;
+		}
+	}
+}
+/* #endif */
+
+// 边框工具类：
+// - nvue 不支持 !important，基础声明供 App-NVUE 使用；
+// - Web/H5/MP 与 App 蒸汽模式保留 !important 覆盖组件内联边框（与上游行为一致）。
+.uv-border {
+	border-style: solid;
+	border-width: 0.5px;
+	border-color: $uv-border-color;
+	/* #ifndef APP-NVUE */
+	border-width: 0.5px !important;
+	border-color: $uv-border-color !important;
+	/* #endif */
+}
+
+.uv-border-top {
+	border-top-style: solid;
+	border-top-width: 0.5px;
+	border-color: $uv-border-color;
+	/* #ifndef APP-NVUE */
+	border-top-width: 0.5px !important;
+	border-color: $uv-border-color !important;
+	/* #endif */
+}
+
+.uv-border-left {
+	border-left-style: solid;
+	border-left-width: 0.5px;
+	border-color: $uv-border-color;
+	/* #ifndef APP-NVUE */
+	border-left-width: 0.5px !important;
+	border-color: $uv-border-color !important;
+	/* #endif */
+}
+
+.uv-border-right {
+	border-right-style: solid;
+	border-right-width: 0.5px;
+	border-color: $uv-border-color;
+	/* #ifndef APP-NVUE */
+	border-right-width: 0.5px !important;
+	border-color: $uv-border-color !important;
+	/* #endif */
+}
+
+.uv-border-bottom {
+	border-bottom-style: solid;
+	border-bottom-width: 0.5px;
+	border-color: $uv-border-color;
+	/* #ifndef APP-NVUE */
+	border-bottom-width: 0.5px !important;
+	border-color: $uv-border-color !important;
+	/* #endif */
+}
+
+.uv-border-top-bottom {
+	border-top-style: solid;
+	border-bottom-style: solid;
+	border-top-width: 0.5px;
+	border-bottom-width: 0.5px;
+	border-color: $uv-border-color;
+	/* #ifndef APP-NVUE */
+	border-top-width: 0.5px !important;
+	border-bottom-width: 0.5px !important;
+	border-color: $uv-border-color !important;
+	/* #endif */
+}
+
+// 去除 button 默认样式，让其表现跟普通 view/text 一致
+// 注意：App 蒸汽模式不支持 font-size/line-height/color: inherit，这里给显式兜底值，
+// 组件内部会通过内联样式/局部 class 覆盖。
+.uv-reset-button {
+	padding: 0;
+	background-color: transparent;
+	border-width: 0;
+	/* #ifndef APP-NVUE */
+	font-size: 16px;
+	line-height: 20px;
+	color: #303133;
+	/* #endif */
+}
+
+/* #ifdef WEB || H5 || MP */
+.uv-reset-button::after {
+	border: none;
+}
+/* #endif */
+
+.uv-hover-class {
+	opacity: 0.7;
+}
+
+// 安全区辅助类（仅非 nvue）：App 使用 uni 安全区变量，Web/小程序使用 env()
+/* #ifndef APP-NVUE */
+@each $d in top, right, bottom, left {
+	.uv-safe-area-inset-#{$d} {
+		padding-#{$d}: 0;
+		/* #ifdef APP */
+		padding-#{$d}: var(--uni-safe-area-inset-#{$d}, 0px);
+		/* #endif */
+		/* #ifdef WEB || H5 || MP */
+		padding-#{$d}: constant(safe-area-inset-#{$d});
+		padding-#{$d}: env(safe-area-inset-#{$d});
+		/* #endif */
+	}
+}
+/* #endif */
+

package/styles/index.scss

@@ -1,7 +1,4 @@
-// 引入公共基础类
-@import "./common.scss";
-
-// 非nvue的样式
-/* #ifndef APP-NVUE */
-@import "./vue.scss";
-/* #endif */
+// 全局样式入口：公共工具类、页面 reset、安全区与 H5 辅助规则。
+// 主题变量由各文件引入的 theme.scss 提供（!default，可被项目覆盖）。
+@import "./common.scss";
+@import "./reset.scss";

package/styles/reset.scss

@@ -0,0 +1,25 @@
+// 页面基础 reset（由 @zfqh/uniapp-x 原 src/styles/reset.scss 迁移）：
+// 仅 H5 / 小程序 / 经典 App 生效；nvue 与 uni-app x App 不支持元素选择器。
+
+/* #ifndef APP-NVUE */
+/* #ifdef WEB || H5 || MP || APP-PLUS */
+page,
+view,
+text,
+scroll-view,
+button,
+image,
+navigator,
+swiper,
+swiper-item {
+	box-sizing: border-box;
+}
+/* #endif */
+
+/* #ifdef WEB || H5 */
+// 提升 H5 端 uni.toast() 的层级，避免被弹层遮盖
+uni-toast {
+	z-index: 10090;
+}
+/* #endif */
+/* #endif */

package/styles/theme.scss

@@ -1,44 +1,40 @@
-// 此文件为uvUI的主题变量，这些变量目前只能通过uni.scss引入才有效，另外由于
-// uni.scss中引入的样式会同时混入到全局样式文件和单独每一个页面的样式中，造成微信程序包太大，
-// 故uni.scss只建议放scss变量名相关样式，其他的样式可以通过main.js或者App.vue引入
-
-$uv-main-color: #303133;
-$uv-content-color: #606266;
-$uv-tips-color: #909193;
-$uv-light-color: #c0c4cc;
-$uv-border-color: #dadbde;
-$uv-bg-color: #f3f4f6;
-$uv-bg-light-color: #fffbf4;
-$uv-disabled-color: #c8c9cc;
-
-$uv-primary: #3c9cff;
-$uv-primary-dark: #398ade;
-$uv-primary-disabled: #9acafc;
-$uv-primary-light: #ecf5ff;
-
-$uv-warning: #f9ae3d;
-$uv-warning-dark: #f1a532;
-$uv-warning-disabled: #f9d39b;
-$uv-warning-light: #fdf6ec;
-
-$uv-success: #5ac725;
-$uv-success-dark: #53c21d;
-$uv-success-disabled: #a9e08f;
-$uv-success-light: #f5fff0;
-
-$uv-error: #f56c6c;
-$uv-error-dark: #e45656;
-$uv-error-disabled: #f7b2b2;
-$uv-error-light: #fef0f0;
-
-$uv-info: #909399;
-$uv-info-dark: #767a82;
-$uv-info-disabled: #c4c6c9;
-$uv-info-light: #f4f4f5;
-
-@mixin flex($direction: row) {
-	/* #ifndef APP-NVUE */
-	display: flex;
-	/* #endif */
-	flex-direction: $direction;
-}
+// 唯一主题色板：只放 SCSS 变量（无 CSS 输出）。
+//
+// - 项目在 uni.scss 中引入 @zfqh/uview-x/styles/theme.scss；
+// - 变量统一使用 !default：项目先/后定义同名变量都能覆盖；
+// - styles/common.scss、styles/reset.scss、styles/var.module.scss 与组件样式都会再次 @import 本文件，
+//   因此这里不能用普通赋值，否则会覆盖项目主题；
+
+$uv-main-color: #303133 !default;
+$uv-content-color: #606266 !default;
+$uv-tips-color: #909193 !default;
+$uv-light-color: #c0c4cc !default;
+$uv-border-color: #dadbde !default;
+$uv-bg-color: #f3f4f6 !default;
+$uv-bg-light-color: #fffbf4 !default;
+$uv-disabled-color: #c8c9cc !default;
+
+$uv-primary: #3c9cff !default;
+$uv-primary-dark: #398ade !default;
+$uv-primary-disabled: #9acafc !default;
+$uv-primary-light: #ecf5ff !default;
+
+$uv-warning: #f9ae3d !default;
+$uv-warning-dark: #f1a532 !default;
+$uv-warning-disabled: #f9d39b !default;
+$uv-warning-light: #fdf6ec !default;
+
+$uv-success: #5ac725 !default;
+$uv-success-dark: #53c21d !default;
+$uv-success-disabled: #a9e08f !default;
+$uv-success-light: #f5fff0 !default;
+
+$uv-error: #f56c6c !default;
+$uv-error-dark: #e45656 !default;
+$uv-error-disabled: #f7b2b2 !default;
+$uv-error-light: #fef0f0 !default;
+
+$uv-info: #909399 !default;
+$uv-info-dark: #767a82 !default;
+$uv-info-disabled: #c4c6c9 !default;
+$uv-info-light: #f4f4f5 !default;

package/styles/var.module.scss

@@ -1,4 +1,4 @@
-@import './color.scss';
+@import './theme.scss';
 
 :export {
   primary: $uv-primary;

package/types/index.d.ts

@@ -48,17 +48,17 @@ declare module 'vue' {
  * 这里声明 `config` 与 4 个 i18n 公共函数 + `useI18n`；包内其余 helper、内部状态与 default/fallback 语言均不对外导出。
  */
 declare module '@zfqh/uview-x' {
-  /** 运行时配置；颜色通过 `config.color` 访问（键为 camelCase，如 `primary`） */
+  /** 运行时配置；颜色通过 `config.color` 访问（键为 camelCase，如 `primary`）；H5 滚动条通过 `config.scrollbar` 控制（默认隐藏） */
   export const config: (typeof import('../utils'))['config'];
-  /** 创建 i18n 实例并挂到 `uni.$i18n`（自动合并 `locales/` 内置组件语言包，用户同名 key 覆盖） */
+  /** 创建 i18n 实例并挂到 `uni.$i18n`（仅注入并深合并默认中文 `zh-Hans`；其他语言需自行 import 语言包后合并） */
   export function createI18n(opts: I18nOptions): I18n;
   /** 获取当前语言（storage `UNI_LOCALE` → `uni.getLocale` → `getAppBaseInfo` → `zh-Hans`） */
   export function getLocale(): string;
-  /** 按当前语言取词（优先全局语言包，其次组件内置语言包；支持 `a.b.c` 路径与 `{name}` 占位符） */
+  /** 按当前语言取词（优先全局语言包，其次默认中文语言包；支持 `a.b.c` 路径与 `{name}` 占位符） */
   export function getLocaleMessage(key: string, values?: Record<string, string | number>): string;
   /** 设置当前语言：更新内部 localeState 与 `uni.$i18n.global.locale`，写 storage `UNI_LOCALE`，最后调用 `uni.setLocale` */
   export function setLocale(locale: string): void;
-  /** i18n hook：未创建 i18n 实例时降级读组件内置语言包，不会抛错 */
+  /** i18n hook：未创建 i18n 实例时降级读默认中文语言包，不会抛错 */
   export const useI18n: typeof import('vue-i18n').useI18n;
 }
 

package/utils/config.ts

@@ -1,6 +1,7 @@
 // #ifndef APP-NVUE
 import vars from '../styles/var.module.scss';
 // #endif
+import type { UviewXScrollbar } from './scrollbar';
 
 export interface UviewXColor {
   primary: string;
@@ -45,25 +46,28 @@ export interface UviewXConfig {
   props: UviewXProps;
   // 默认单位，可以通过配置为 rpx，那么在用于传入组件大小参数为数值时，就默认为 rpx
   unit: string;
+  // H5 全局滚动条：false 隐藏（默认）；true 使用默认样式；对象在默认样式上自定义
+  scrollbar: UviewXScrollbar;
 }
 
 export type UviewXColorConfig = Partial<UviewXColor>;
 
-// 兜底色板与 styles/color.scss 保持一致；非 nvue 端会由 var.module.scss 覆盖为实际主题色
+// 兜底色板与 styles/theme.scss 默认值保持一致（nvue 无法读取 SCSS，使用常量兜底）；
+// 非 nvue 端会由 var.module.scss 覆盖为实际主题色。
 const color: UviewXColor = {
-  primary: '#00b4c3',
-  primaryDark: '#157572',
-  primaryDisabled: '#b4e3d9',
-  primaryLight: '#dff3f9',
+  primary: '#3c9cff',
+  primaryDark: '#398ade',
+  primaryDisabled: '#9acafc',
+  primaryLight: '#ecf5ff',
   success: '#5ac725',
   successDark: '#53c21d',
   successDisabled: '#a9e08f',
   successLight: '#f5fff0',
-  warning: '#ff9a05',
-  warningDark: '#ed6c04',
+  warning: '#f9ae3d',
+  warningDark: '#f1a532',
   warningDisabled: '#f9d39b',
   warningLight: '#fdf6ec',
-  error: '#ff4d4f',
+  error: '#f56c6c',
   errorDark: '#e45656',
   errorDisabled: '#f7b2b2',
   errorLight: '#fef0f0',
@@ -71,14 +75,14 @@ const color: UviewXColor = {
   infoDark: '#767a82',
   infoDisabled: '#c4c6c9',
   infoLight: '#f4f4f5',
-  bgColor: '#f5f5f5',
+  bgColor: '#f3f4f6',
   bgLightColor: '#fffbf4',
-  mainColor: '#333333',
-  contentColor: '#7a7a7a',
-  tipsColor: '#9a9a9a',
+  mainColor: '#303133',
+  contentColor: '#606266',
+  tipsColor: '#909193',
   lightColor: '#c0c4cc',
   disabledColor: '#c8c9cc',
-  borderColor: '#eeeeee',
+  borderColor: '#dadbde',
 };
 
 // #ifndef APP-NVUE
@@ -90,6 +94,7 @@ const config: UviewXConfig = {
   color,
   props: {},
   unit: 'px',
+  scrollbar: false,
 };
 
 export default config;

package/utils/function.ts

@@ -302,7 +302,9 @@ export function deepMerge<T extends object>(target: T = {} as T, source: Partial
     } else if (sourceValue instanceof Set) {
       merged[prop] = new Set(sourceValue);
     } else if (typeof sourceValue === 'object' && sourceValue !== null) {
-      merged[prop] = deepMerge(targetValue, sourceValue);
+      // 目标是原始值 / null 时，用对象源替换；避免 `false`、`undefined` 等无法被深合并
+      const mergedTarget = typeof targetValue === 'object' && targetValue !== null ? targetValue : {};
+      merged[prop] = deepMerge(mergedTarget, sourceValue);
     } else {
       merged[prop] = sourceValue;
     }
@@ -754,18 +756,17 @@ export function getHistoryPage(back = 0): ReturnType<typeof getCurrentPages>[num
 
 /**
  * @description 修改 uview-x 运行时内置属性值
- * @param {object} config 修改内置 config 属性
- * @param {object} color 修改内置 color 属性
+ *
+ * 直接传 config 字段：
+ * `setConfig({ unit: 'rpx', type: [...], scrollbar: true, color: {...}, props: {...} })`
  */
-export interface SetConfigOptions {
-  config?: Partial<UviewXConfig>;
+export type SetConfigOptions = Omit<Partial<UviewXConfig>, 'color' | 'props'> & {
+  /** 修改内置 color 属性（与默认色板深合并） */
   color?: Partial<UviewXColor>;
+  /** 修改组件默认 props（与已有 props 深合并） */
   props?: UviewXProps;
-}
+};
 
-export function setConfig({ config: configPatch = {}, color = {}, props = {} }: SetConfigOptions = {}): void {
-  const merged = deepMerge(config, configPatch);
-  Object.assign(config, merged);
-  config.color = deepMerge(config.color, color);
-  config.props = deepMerge(config.props, props);
+export function setConfig(options: SetConfigOptions = {}): void {
+  Object.assign(config, deepMerge(config, options as Partial<UviewXConfig>));
 }

package/utils/index.ts

@@ -52,6 +52,7 @@ export { range } from './function';
 
 // 对外类型：工具配置、路由、压缩与平台
 export type { UviewXConfig } from './config';
+export type { UviewXScrollbar, UviewXScrollbarOptions, UviewXScrollbarStyle } from './scrollbar';
 export type { CompressOptions } from './compress';
 export type { RouteFunction, RouteOptions, RouteParams, RouteType } from './route';
 export type { UviewXPlatform } from './platform';

package/utils/locale.ts

@@ -2,10 +2,13 @@ import { ref } from 'vue';
 import type { Ref } from 'vue';
 import { createI18n as _createI18n } from 'vue-i18n';
 import type { I18n, I18nOptions } from 'vue-i18n';
-import { getBuiltinMessage, mergeComponentMessages } from '../locales';
+import { getBuiltinMessage, mergeDefaultMessages } from '../locales';
 
 /**
- * 国际化能力（组件内置语言包 + 4 个公共 API）。
+ * 国际化能力（默认中文 + 可选语言包 + 4 个公共 API）。
+ *
+ * 默认语言只有简体中文（`zh-Hans`），`createI18n` 只注入并深合并内置中文；
+ * 英文等其他语言为独立语言包（`locales/en.ts`），由使用方显式引入后合并进 `messages`。
  *
  * 公共 API（由 `utils/index.ts` 导出到包入口）：
  * `createI18n`、`getLocale`、`getLocaleMessage`、`setLocale`。
@@ -187,7 +190,8 @@ function getMessage(messages: I18nMessages, locale: string, key: string): string
  * 翻译（App / 小程序 / 无 i18n 实例时的统一实现）。
  *
  * locale 优先级：storage `UNI_LOCALE` → `uni.$i18n.global.locale` → 内部 `localeState` → `zh-Hans`；
- * 消息优先级：全局语言包（当前语言 → 回退语言）→ 组件内置语言包（当前语言 → 回退语言）→ key。
+ * 消息优先级：全局语言包（当前语言 → 中文回退）→ 内置中文默认语言包 → key。
+ * 其他语言（如英文）由使用方在 `createI18n` 中显式合并，未合并时回退中文。
  * storage 优先用于 nvue 等页面上下文模块副本不同、实例未共享的场景（setLocale 已先落盘）。
  */
 export function appTranslate(key: string, values?: Record<string, string | number>): string {
@@ -206,14 +210,18 @@ export function appTranslate(key: string, values?: Record<string, string | numbe
 /**
  * 创建 i18n 实例并挂到 `uni.$i18n`。
  *
- * - 自动把组件内置语言包合并进 `opts.messages`（用户同名 key 优先）；
+ * - 只注入内置默认中文：`mergeDefaultMessages(opts.messages)` 仅深合并 `zh-Hans`，
+ *   用户同名 key 优先；其他 locale（如显式引入的 `en`）原样透传，不做内置补全；
+ * - 未显式传 `fallbackLocale` 时默认 `zh-Hans`，未合并的语言回退中文；
  * - App 端不依赖 vue-i18n 注入，直接把 `global.t` 替换为包内 `appTranslate`；
  * - 用 `opts.locale` 初始化内部 `localeState`，无实例时也能保持语言一致。
  */
 export function createI18n(opts: I18nOptions): I18n {
-  const mergedMessages: I18nMessages = mergeComponentMessages(opts.messages as I18nMessages | undefined);
+  const mergedMessages: I18nMessages = mergeDefaultMessages(opts.messages as I18nMessages | undefined);
   const mergedOptions: I18nOptions = {
     ...opts,
+    // 默认回退中文；显式传入的值（含 false）优先
+    fallbackLocale: opts.fallbackLocale ?? fallbackLocale,
     // #ifdef WEB || H5
     // vue-i18n 9.1.9 的 globalInjection 默认 false；H5 开启后 app.use(i18n) 会注入
     // `app.config.globalProperties.$i18n`，useI18n 才能检测到实例并走 vue-i18n 分支
@@ -288,7 +296,7 @@ export function setLocale(locale: string): void {
 
 /**
  * 按当前语言取词（公共 API）。
- * 统一走 `appTranslate`（优先读 `uni.$i18n` 语言包，其次组件内置语言包），
+ * 统一走 `appTranslate`（优先读 `uni.$i18n` 语言包，其次默认中文语言包），
  * 避免小程序端 vue-i18n runtime-only 构建缺少消息编译器导致翻译空白 / 占位符不插值。
  */
 export function getLocaleMessage(key: string, values?: Record<string, string | number>): string {