generator-mico-cli 0.2.26 → 0.2.28

package/README.md

@@ -216,7 +216,9 @@ pnpm test:watch
 | `tests/integration/micro-react.test.js` | micro-react 生成器集成测试 |
 | `tests/integration/subapp-react.test.js` | subapp-react 生成器集成测试 |
 | `tests/integration/subapp-umd.test.js` | subapp-umd 生成器集成测试 |
+| `tests/integration/mico-cli.test.js` | `mico` 入口子进程测试（help / version / list / create 透传） |
 | `tests/helpers/setup.js` | 测试共享工具（路径常量、monorepo fixture 工厂） |
+| `tests/helpers/mico-subprocess.js` | 子进程运行 `bin/mico.js`、假 `yo` 工具函数 |
 
 ### Scripts 说明
 

package/generators/micro-react/templates/apps/layout/config/config.dev.ts

@@ -33,6 +33,9 @@ const config: ReturnType<typeof defineConfig> = {
           // noLayoutRouteList: [],
           // 关闭权限控制（调试用）
           disableAuth: false,
+          // SSO 外跳地址（与 resolveExternalLoginPath 读取的 externalLoginPath 一致；生产由注入的 __MICO_CONFIG__ 提供）
+          externalLoginPath:
+            'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
         };
       `,
     },
@@ -64,13 +67,10 @@ const config: ReturnType<typeof defineConfig> = {
   define: {
     'process.env.NODE_ENV': 'development',
     'process.env.API_BASE_URL': '',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
 };
 

package/generators/micro-react/templates/apps/layout/config/config.prod.development.ts

@@ -29,13 +29,10 @@ const config: ReturnType<typeof defineConfig> = {
   define: {
     'process.env.NODE_ENV': 'development',
     'process.env.API_BASE_URL': 'https://dashboard-api-test.micoplatform.com',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
 };
 

package/generators/micro-react/templates/apps/layout/config/config.prod.testing.ts

@@ -29,13 +29,10 @@ const config: ReturnType<typeof defineConfig> = {
   define: {
     'process.env.NODE_ENV': 'testing',
     'process.env.API_BASE_URL': 'https://dashboard-api-test.micoplatform.com',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api-test.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
 };
 

package/generators/micro-react/templates/apps/layout/config/config.prod.ts

@@ -17,13 +17,10 @@ const config: ReturnType<typeof defineConfig> = {
   define: {
     'process.env.NODE_ENV': 'production',
     'process.env.API_BASE_URL': 'https://dashboard-api.micoplatform.com',
-    'process.env.PROXY_SUFFIX': '/proxy/<%= projectName %>_svr',
     'process.env.LOGIN_ENDPOINT':
       'https://dashboard-api.micoplatform.com/api/yufu_login/',
     'process.env.REFRESH_ENDPOINT':
       'https://dashboard-api.micoplatform.com/api/yufu_login/refresh/',
-    'process.env.EXTERNAL_LOGIN_PATH':
-      'https://micous-idp.cig.tencentcs.com/sso/xxxxxxx/cas',
   },
   externals: {
     react: 'React',
@@ -34,7 +31,7 @@ const config: ReturnType<typeof defineConfig> = {
   extraBabelPlugins: ['babel-plugin-dynamic-import-node'],
 
   // 禁用代码分割，只输出一个 JS 和一个 CSS
-  chainWebpack(memo) {
+  chainWebpack(memo: any) {
     // 禁用 splitChunks
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk

package/generators/micro-react/templates/apps/layout/docs/feat-/346/236/204/345/273/272define/344/270/216/345/205/215/350/256/244/350/257/201/345/210/235/345/247/213/346/200/201.md

@@ -0,0 +1,44 @@
+# 构建 define 精简与免认证页初始态
+
+> 创建时间：2026-03-24
+
+## 功能概述
+
+1. **Umi `define`**：不再通过构建期注入 `process.env.EXTERNAL_LOGIN_PATH`（本模板从未注入 `APP_ID`）；SSO 外跳等依赖运行时 `window.__MICO_CONFIG__`。
+2. **`getInitialState`**：免认证路由下即使本地仍有 token，也不请求用户信息接口，减少无效调用。
+
+## 技术方案
+
+### 开发环境
+
+`config/config.dev.ts` 的 `headScripts` 中 `window.__MICO_CONFIG__` 增加 **`externalLoginPath`**（模板默认为占位 URL，生成项目后请按实际 IdP 修改）。
+
+`define` 仅保留 `NODE_ENV`、`API_BASE_URL`、`LOGIN_ENDPOINT`、`REFRESH_ENDPOINT`。
+
+### 生产 / 测试构建
+
+`config.prod.ts`、`config.prod.development.ts`、`config.prod.testing.ts` 的 `define` 中同样**不包含** `EXTERNAL_LOGIN_PATH`，由部署时注入的 `__MICO_CONFIG__.externalLoginPath`（或 `__MICO_WORKSPACE__.casServerLoginUrl`）提供。
+
+### 初始态
+
+`src/app.tsx` 中仅在 `getStoredAuthToken() && !skipAuth` 时调用 `fetchUserInfoFn()`；`skipAuth = isNoAuthRoute || isPageAuthFree`。
+
+## 文件清单
+
+| 文件路径 | 说明 |
+| --- | --- |
+| `config/config.dev.ts` | `__MICO_CONFIG__.externalLoginPath`；移除 `EXTERNAL_LOGIN_PATH` define |
+| `config/config.prod.ts` | 移除 `EXTERNAL_LOGIN_PATH` define |
+| `config/config.prod.development.ts` | 同上 |
+| `config/config.prod.testing.ts` | 同上 |
+| `src/app.tsx` | `fetchUserInfo` 条件增加 `!skipAuth` |
+
+## 部署注意
+
+- 生产 HTML 或网关需保证 `window.__MICO_CONFIG__` 含 **`appId`**、**`externalLoginPath`**（或与现有网关字段对齐），否则代理前缀、SSO 外跳可能异常。
+- 详见 `src/common/request/config.ts` 中 `buildDefaultClientOptions` 的解析顺序。
+
+## 相关文档
+
+- [fix-SSO无限重定向](./fix-SSO无限重定向.md)
+- [arch-请求模块](./arch-请求模块.md)

package/generators/micro-react/templates/apps/layout/docs/feature-/345/276/256/345/211/215/347/253/257/346/250/241/345/274/217.md

@@ -1,7 +1,7 @@
 # 微前端模式
 
 > 创建时间：2025-12-26
-> 更新时间：2025-01-25（加载健壮性增强）
+> 更新时间：2025-03-20（MicroAppLoader 增加 base 与 normalizeMicroAppBase）
 
 ## 功能概述
 
@@ -45,6 +45,8 @@
 
 ```typescript
 interface MicroAppLoaderProps {
+  /** 微应用在主应用中的挂载路径前缀（来自 ParsedRoute.base / 页面配置 base），经 normalizeMicroAppBase 后传给子应用 */
+  base: string;
   /** 微应用入口 URL */
   entry: string;
   /** 微应用名称 */
@@ -60,11 +62,47 @@ interface MicroAppLoaderProps {
 
 | 参数 | 类型 | 必填 | 说明 |
 |------|------|------|------|
+| base | string | 是 | 挂载路径前缀；经 `normalizeMicroAppBase` 后作为子应用 `props.base` |
 | entry | string | 是 | qiankun 入口 URL (htmlUrl 或 jsUrls[0]) |
 | name | string | 是 | 微应用唯一标识 |
 | displayName | string | 否 | 显示名称，用于加载提示 |
 | routePath | string | 否 | 当前路由路径，用于子应用内部路由切换 |
 
+### MicroAppLoader 路由与 base
+
+主应用为微应用补充 **挂载前缀 `base`**，便于子应用对齐 basename、publicPath、内部路由等与路径相关的逻辑；**是否与免鉴权配置做前缀匹配**以当前实现为准（见下「加载门控」）。
+
+#### `base` 与 `routePath` 的区别
+
+| 字段 | 含义 |
+| --- | --- |
+| **base** | 该微应用在主应用中的**挂载前缀**，来自中台 **`page.base`**，解析为 **`ParsedRoute.base`**（缺省时解析为 **`'/'`**）；可与动态路由 **`path`** 不同（如 `path` 为 `/subapp/*` 时 `base` 可为 `/subapp`）。 |
+| **routePath** | 当前激活的**完整路由路径**，随浏览器 URL 变化，用于通知子应用做**内部路由同步**。 |
+
+`routePath` 在布局内为 **`currentRoute.path`**。`base` 在 **`patchClientRoutes`** 与布局内均为 **`route.base` / `currentRoute.base`**。**`name`** 在布局侧常为基于 **`entry`** 的 **`getAppNameFromEntry`**，与 **`base`** 来源不同，需注意。
+
+#### `normalizeMicroAppBase`
+
+组件内导出工具函数（见 `MicroAppLoader/index.tsx`）：
+
+```typescript
+export const normalizeMicroAppBase = (path: string): string =>
+  path.replace(/\/+$/, '').replace(/\*+$/, '');
+```
+
+含义：先去掉末尾 `/`，再去掉末尾 `*`（兼容路由表中的 `/foo/*` 等写法）。**传给子应用的 `props.base` 为规范化后的字符串**。
+
+#### 调用处传参
+
+| 位置 | 说明 |
+| --- | --- |
+| `src/app.tsx` `patchClientRoutes` | 动态注册微应用路由时：`React.createElement(MicroAppLoader, { entry, name: route.path, base: route.base, ... })` |
+| `src/layouts/index.tsx` | 布局内渲染：`<MicroAppLoader base={currentRoute.base} routePath={currentRoute.path} ... />` |
+
+#### 加载门控（认证）
+
+微应用开始执行 `switchTo` / 挂载前，需 **`isAuthReady`**（`isAuthDisabled`、`isPageAuthFree`、`isNoAuthRoute(location.pathname)`、`isNoPermissionRoute(location.pathname)` 或已存在 `currentUser` 等，见组件内实现）。**当前以浏览器 `location.pathname` 与全局常量为准**，未单独使用 `base` 与 `window.__MICO_CONFIG__.noAuthRouteList` 做前缀匹配。
+
 ### MicroAppProps (传递给子应用)
 
 ```typescript
@@ -87,6 +125,8 @@ interface MicroAppProps {
   timezone: string;
   /** 在线状态 */
   presenceStatus: string;
+  /** 挂载路径前缀（为 `normalizeMicroAppBase(MicroAppLoader.base)`） */
+  base: string;
   /** 当前路由路径 */
   routePath?: string;
   /** 共享的 request 实例，子应用可直接使用 */
@@ -125,6 +165,8 @@ export async function update(props: MicroAppProps) {
 ```typescript
 interface ParsedRoute {
   path: string;
+  /** 微应用挂载前缀（来自 page.base，解析缺省为 '/'） */
+  base: string;
   name: string;
   icon: string;
   /** 加载类型: internal(内部路由) | microapp(qiankun微应用) */
@@ -142,6 +184,8 @@ interface PageConfig {
   id: number;
   name: string;
   route: string;
+  /** 微应用挂载前缀（可与 route 不同） */
+  base: string;
   enabled: boolean;
   /** 微应用 HTML 入口 URL (优先使用) */
   htmlUrl: string | null;
@@ -211,7 +255,12 @@ const menus: MenuItem[] = [
 const renderContent = () => {
   if (currentRoute?.loadType === 'microapp' && currentRoute.entry) {
     return (
-      <MicroAppLoader entry={currentRoute.entry} name={currentRoute.name} />
+      <MicroAppLoader
+        entry={currentRoute.entry}
+        name={currentRoute.name}
+        base={currentRoute.base}
+        routePath={currentRoute.path}
+      />
     );
   }
   return <Outlet />;

package/generators/micro-react/templates/apps/layout/mock/menus.ts

@@ -80,7 +80,7 @@ const mockMenus: MockMenuItem[] = [
         nameEn: 'Subapp Page',
         nameKey: 'cs_web_menu_subapp_page',
         type: 'page',
-        path: '/subapp/*',
+        path: '/subapp',
         icon: 'Desktop',
         enabled: true,
         sortOrder: 1,

package/generators/micro-react/templates/apps/layout/mock/pages.ts

@@ -28,6 +28,7 @@ const mockPages: PublicPageItem[] = [
     nameEn: 'Login',
     nameKey: 'page.user.login',
     route: '/user/login',
+    base: '/user/login',
     htmlUrl:
       'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/login/index.html',
     jsUrls: [],
@@ -47,6 +48,7 @@ const mockPages: PublicPageItem[] = [
     nameEn: 'Permission Management',
     nameKey: 'page.permission',
     route: '/permission',
+    base: '/',
     htmlUrl:
       'https://cdn-portal.micoplatform.com/portal-center/common-web/0.0.4/permission/index.html',
     jsUrls: [],
@@ -66,6 +68,7 @@ const mockPages: PublicPageItem[] = [
     nameEn: 'Fallback',
     nameKey: 'page.fallback',
     route: '/*',
+    base: '/',
     htmlUrl: '',
     jsUrls: [],
     cssUrls: [],

package/generators/micro-react/templates/apps/layout/src/app.tsx

@@ -138,7 +138,8 @@ export async function getInitialState(): Promise<{
   }
 
   // 有 token 就获取用户信息（无论在哪个页面，支持登录后 refresh 场景）
-  if (getStoredAuthToken()) {
+  // 当页面免认证时，不获取用户信息
+  if (getStoredAuthToken() && !skipAuth) {
     const userInfo = await fetchUserInfoFn();
     if (userInfo) {
       clearRedirectCount();
@@ -226,6 +227,7 @@ export function patchClientRoutes({ routes }: { routes: UmiRoute[] }) {
         ? React.createElement(MicroAppLoader, {
             entry: route.entry,
             name: route.path,
+            base: route.base,
             displayName: route.name,
           })
         : undefined;

package/generators/micro-react/templates/apps/layout/src/common/menu/parser.ts

@@ -22,6 +22,7 @@ export const extractRoutesFromPages = (
       return {
         path: page.route,
         name: page.name,
+        base: page.base || '/',
         icon: '',
         loadType: (hasEntry ? 'microapp' : 'internal') as
           | 'internal'
@@ -269,6 +270,7 @@ export const extractRoutes = (
       if (page && page.enabled) {
         routes.push({
           path: page.route,
+          base: page.base || '/',
           name: item.name,
           nameEn: item.nameEn,
           icon: item.icon,

package/generators/micro-react/templates/apps/layout/src/common/menu/types.ts

@@ -16,6 +16,8 @@ export interface PageConfig {
   nameKey?: string;
   /** 路由路径 */
   route: string;
+  /** 路由前缀路径 */
+  base: string;
   /** 是否启用 */
   enabled: boolean;
   /** 微应用 HTML 入口 URL (用于 qiankun 加载) */
@@ -90,6 +92,8 @@ export interface MenuItem {
  */
 export interface ParsedRoute {
   path: string;
+  /** 微应用在主应用中的挂载前缀（来自页面配置 base，可与 path 不同） */
+  base: string;
   /** 菜单显示名称（中文） */
   name: string;
   /** 菜单显示名称（英文） */

package/generators/micro-react/templates/apps/layout/src/common/request/config.ts

@@ -3,6 +3,7 @@
  * appId 优先从 window.__MICO_WORKSPACE__ 获取，其次从 window.__MICO_CONFIG__ 获取；
  * externalLoginPath 优先从 window.__MICO_WORKSPACE__.casServerLoginUrl 获取；
  * 其余 apiBaseUrl / proxySuffix / loginEndpoint / refreshEndpoint 优先从 window.__MICO_CONFIG__ 同名字段获取，兜底取 process.env 环境变量。
+ * proxySuffix：若 __MICO_CONFIG__.proxySuffix 与 process.env.PROXY_SUFFIX 均未配置，则按已解析的 appId 推导为 /proxy/${appId}_svr。
  */
 
 import { getStoredAuthToken } from '../auth/auth-manager';
@@ -18,6 +19,15 @@ function getMicoWorkspace(): Window['__MICO_WORKSPACE__'] {
   return window.__MICO_WORKSPACE__ ?? undefined;
 }
 
+/** 显式 proxySuffix 优先；否则在有 appId 时使用 /proxy/${appId}_svr */
+function resolveProxySuffixWithFallback(
+  explicit: string,
+  appId: string,
+): string {
+  if (explicit) return explicit;
+  return appId ? `/proxy/${appId}_svr` : '';
+}
+
 function buildDefaultClientOptions(): RequestClientOptions {
   const envDefaults: RequestClientOptions = {
     appId: '',
@@ -36,14 +46,27 @@ function buildDefaultClientOptions(): RequestClientOptions {
       ? String(workspace.appId)
       : undefined;
   const externalLoginFromWorkspace = workspace?.casServerLoginUrl;
-  if (!mico && !appIdFromWorkspace && !externalLoginFromWorkspace)
-    return envDefaults;
+  if (!mico && !appIdFromWorkspace && !externalLoginFromWorkspace) {
+    return {
+      ...envDefaults,
+      proxySuffix: resolveProxySuffixWithFallback(
+        envDefaults.proxySuffix,
+        envDefaults.appId,
+      ),
+    };
+  }
+  const resolvedAppId =
+    appIdFromWorkspace ?? mico?.appId ?? envDefaults.appId;
+  const explicitProxy = mico?.proxySuffix ?? envDefaults.proxySuffix;
   return {
     ...envDefaults,
     ...(mico?.defaultClientOptions ?? {}),
-    appId: appIdFromWorkspace ?? mico?.appId ?? envDefaults.appId,
+    appId: resolvedAppId,
     apiBaseUrl: mico?.apiBaseUrl ?? envDefaults.apiBaseUrl,
-    proxySuffix: mico?.proxySuffix ?? envDefaults.proxySuffix,
+    proxySuffix: resolveProxySuffixWithFallback(
+      explicitProxy,
+      resolvedAppId,
+    ),
     loginEndpoint: mico?.loginEndpoint ?? envDefaults.loginEndpoint,
     refreshEndpoint: mico?.refreshEndpoint ?? envDefaults.refreshEndpoint,
     externalLoginPath:

package/generators/micro-react/templates/apps/layout/src/components/MicroAppLoader/index.tsx

@@ -11,6 +11,8 @@ import './index.less';
 import { microAppManager, type MicroAppState } from './micro-app-manager';
 
 interface MicroAppLoaderProps {
+  /** 微应用在主应用中的挂载路径前缀（来自 ParsedRoute.base / 页面配置 base），经 normalizeMicroAppBase 后传给子应用 */
+  base: string;
   entry: string;
   name: string;
   displayName?: string;
@@ -18,6 +20,10 @@ interface MicroAppLoaderProps {
   routePath?: string;
 }
 
+/** 微应用 base：先去掉末尾 /，再去掉末尾 *（与路由 path 约定一致） */
+export const normalizeMicroAppBase = (path: string): string =>
+  path.replace(/\/+$/, '').replace(/\*+$/, '');
+
 const sanitizeId = (path: string): string => {
   return (
     path
@@ -35,6 +41,7 @@ const sanitizeId = (path: string): string => {
  * 用户意图追踪在 MicroAppManager 内部处理。
  */
 const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
+  base,
   entry,
   name,
   displayName,
@@ -77,6 +84,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
       uid: authInfo.uid,
       avatar: authInfo.avatar,
       nickname: authInfo.nickname,
+      base: normalizeMicroAppBase(base || '/'),
       // 传递当前路由路径，让子应用进行内部路由切换
       routePath,
       // 传递主应用的 request 实例，子应用可直接使用
@@ -84,7 +92,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
       // 传递当前多语言类型给子应用（zh-CN, en-US）
       locale: getCurrentLocale(),
     };
-  }, [env, routePath]);
+  }, [base, env, routePath]);
 
   // ref 持有最新的 buildProps，避免加载 effect 依赖它导致子应用被重载
   const buildPropsRef = useRef(buildProps);
@@ -129,7 +137,7 @@ const MicroAppLoader: React.FC<MicroAppLoaderProps> = ({
       microAppManager.cancel();
       microAppManager.setStateCallback(null);
     };
-  }, [entry, appName, isAuthReady]);
+  }, [entry, appName, isAuthReady, buildProps]);
 
   return (
     <div className="micro-app-container">

package/generators/micro-react/templates/apps/layout/src/layouts/index.tsx

@@ -184,6 +184,7 @@ const BasicLayout: React.FC = () => {
             // 同一个微应用的不同路由共用同一个实例
             key={appName}
             entry={currentRoute.entry}
+            base={currentRoute.base}
             // 使用 entry 生成的标识，而不是 path
             name={appName}
             // 显示名称用于 loading 提示

package/generators/micro-react/templates/packages/common-intl/src/intl.ts

@@ -37,7 +37,13 @@ const intlProxy = new Proxy(intl, {
     }
     // 不存在的 key，返回一个兜底函数
     console.warn(`[common-intl] Missing intl key: ${prop}`);
-    return () => prop; // 返回 key 本身作为兜底文案
+    // 未预定义的 key：仍从缓存（接口拉取的多语言数据）中查找，支持动态 key
+    return (...interpolations: Array<string | number | undefined>) =>
+      i18n({
+        key: prop,
+        interpolations,
+        defaultMessage: prop, // 缓存无值时用 key 兜底
+    });
   },
 });
 

package/generators/subapp-react/index.js

@@ -323,6 +323,7 @@ module.exports = class extends Generator {
         `    nameEn: '${this.appNamePascal}',`,
         `    nameKey: 'page.${this.appName}',`,
         `    route: '/${this.appName}',`,
+        `    base: '/${this.appName}',`,
         `    htmlUrl: '//localhost:${this.devPort}',`,
         '    jsUrls: [],',
         '    cssUrls: [],',

package/generators/subapp-react/templates/homepage/config/config.prod.development.ts

@@ -25,6 +25,7 @@ const config: ReturnType<typeof defineConfig> = {
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    memo.plugins.delete('runtimePublicPath');
     // 开发环境，不上传 sourcemap。调试时如有需要再解开
     // applySentryPlugin({ memo, appName: '<%= appName %>' });
     return memo;

package/generators/subapp-react/templates/homepage/config/config.prod.testing.ts

@@ -25,6 +25,7 @@ const config: ReturnType<typeof defineConfig> = {
     memo.optimization.splitChunks(false);
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
+    memo.plugins.delete('runtimePublicPath');
     // 测试环境，不上传 sourcemap。调试时如有需要再解开
     // applySentryPlugin({ memo, appName: '<%= appName %>' });
     return memo;

package/generators/subapp-react/templates/homepage/config/config.prod.ts

@@ -24,6 +24,7 @@ const config: ReturnType<typeof defineConfig> = {
     // 禁用 runtimeChunk
     memo.optimization.runtimeChunk(false);
     applySentryPlugin({ memo, appName: '<%= appName %>' });
+    memo.plugins.delete('runtimePublicPath');
     return memo;
   },
   publicPath: PUBLIC_PATH,

package/generators/subapp-react/templates/homepage/config/config.ts

@@ -30,13 +30,6 @@ const config: ReturnType<typeof defineConfig> = {
 
   publicPath: PUBLIC_PATH,
 
-  // qiankun slave 插件默认开启 runtimePublicPath，会在构建时将 CSS url() 的 publicPath 覆盖为 '/'
-  // 生产环境 publicPath 已确定，删除该插件让 cssPublicPath 生效
-  chainWebpack(memo) {
-    memo.plugins.delete('runtimePublicPath');
-    return memo;
-  },
-
   /**
    * @name 运行时公共路径
    * @description qiankun 微应用运行时动态设置 publicPath

package/generators/subapp-react/templates/homepage/config/routes.ts

@@ -3,5 +3,5 @@
  * @description <%= appName %> 子应用的路由配置
  */
 export default [
-  { path: '/<%= appName %>', component: '@/pages/index' },
+  { path: '/', component: '@/pages/index' },
 ];

package/generators/subapp-react/templates/homepage/src/app.tsx

@@ -13,6 +13,11 @@ import { SentryErrorBoundary } from '@common-web/sentry';
 import { appLogger } from './common/logger';
 import { type IMicroAppProps, setMainAppProps } from './common/mainApp';
 
+/** 与 layout parser.findRouteByPath 一致：根路径 "/" 保持不变 */
+function stripTrailingSlash(path: string): string {
+  return path.length > 1 && path.endsWith('/') ? path.slice(0, -1) : path;
+}
+
 /**
  * @name 路由同步工具
  * @description 处理主应用与子应用之间的路由同步，支持通配符路由模式
@@ -20,12 +25,12 @@ import { type IMicroAppProps, setMainAppProps } from './common/mainApp';
 function syncRoute(routePath: string, logPrefix = 'route sync') {
   if (!history) return;
 
-  const currentPath = history.location.pathname;
+  const currentPath = stripTrailingSlash(history.location.pathname);
   const isWildcard = routePath.endsWith('/*');
-  // 通配符模式取基础路径，否则使用原路径
-  const targetPath = isWildcard ? routePath.slice(0, -2) : routePath;
+  const targetPath = stripTrailingSlash(
+    isWildcard ? routePath.slice(0, -2) : routePath,
+  );
 
-  // 判断当前路径是否已匹配目标
   const isMatched = isWildcard
     ? currentPath === targetPath || currentPath.startsWith(`${targetPath}/`)
     : currentPath === targetPath;

package/lib/utils.js

@@ -2,7 +2,7 @@
 
 const fs = require('node:fs');
 const path = require('node:path');
-const { execSync, execFileSync, execFile } = require('node:child_process');
+const { exec, execSync, execFileSync, execFile } = require('node:child_process');
 const os = require('node:os');
 
 /**

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "generator-mico-cli",
-  "version": "0.2.26",
+  "version": "0.2.28",
   "description": "Yeoman generator for Mico CLI projects",
   "keywords": [
     "yeoman-generator",
@@ -18,6 +18,7 @@
     "generators"
   ],
   "scripts": {
+    "prepare": "husky",
     "format": "biome format --write .",
     "format:check": "biome format .",
     "test": "vitest run",
@@ -27,6 +28,7 @@
   },
   "devDependencies": {
     "@biomejs/biome": "^1.9.4",
+    "husky": "^9.1.7",
     "vitest": "^4.0.18",
     "yeoman-environment": "^3.19.3",
     "yeoman-test": "^6.3.0"