Astro 插件机制与 Vite 编译时代码注入#

1
export function i18nKeyPrefixPlugin() {
2
    return {
3
        // 插件名称，用于在 Vite 调试和日志中识别
4
        name: 'i18n-key-prefix-plugin',
5

6
        // 强制插件在 Vite 核心插件之前运行 (pre-phase)
7
        enforce: 'pre',
8

9
        // transform 是 Vite 最核心的钩子之一
10
        // code: 当前文件的源码文本
11
        // id:   当前文件的绝对路径
12
        transform(code, id) {
13
            // 1. 仅拦截特定的文件：必须是位于 /i18n/partials/ 目录下，并且以 /keys.ts 结尾的文件。
14
            if (id.includes('/i18n/partials/') && id.endsWith('/keys.ts')) {
15

16
                // 2. 使用正则表达式从文件路径中提取出“模块名称”（如 friends）
17
                const match = id.match(/\/partials\/(.+)\/keys\.ts$/);
18
                if (match) {
19
                    const folderName = match[1]; // 提取到的文件夹名，即前缀内容
20

21
                    return {
22
                        // 3. 核心替换逻辑
23
                        code: code.replace(/(=|:)\s*(['"`])([^'"`]+)\2/g, (match, op, quote, val) => {
24
                            // 如果值已经以 '[' 开头，说明已经被处理过，直接跳过
25
                            if (val.startsWith('[')) return match;
26

27
                            // 将原有的值替换为带前缀的值。例如 'tag.friend' -> '[friends]tag.friend'
28
                            return `${op} ${quote}[${folderName}]${val}${quote}`;
29
                        }),
30
                        // 不生成 SourceMap
31
                        map: null
32
                    };
33
                }
34
            }
35
        }
36
    };
37
}