// 契约:小程序 WXML 必须结构自洽(可被编译) // // 由来(2026-09-19):微信开发者工具报 // [ WXML 文件编译错误] ./pages/service-history/service-history.wxml // get tag end without start, near `` 进入仓库且长期无人发现。 // // 本守卫补上这一层:按引号状态机解析标签配对,任何多余闭合/错配/未闭合直接判红。 // // 自检(防止守卫自己变哑):内置 3 组样例,正向 1 组 + 反向 2 组。 // 正向样例**故意在属性值里放了 `>`**(`"{{a > 0}}"`)—— 早期用懒惰正则实现时, // 这里会被误判为结构错误(假阳性),把 messages.wxml 这种合法文件报成坏文件。 // 把该样例固化进守卫,等于把「假阳性」这个坑钉在门禁里。 import assert from 'node:assert/strict' import { readFileSync } from 'node:fs' import { relative, resolve } from 'node:path' import { checkWxml, walkWxml } from '../scripts/lib/wxml-structure.mjs' const root = resolve(import.meta.dirname, '..') // ── 1. 扫描器自检 ──────────────────────────────────────────────── const selfCheckCases = [ { name: '正向:属性值内含 `>` 比较运算符(早期正则实现的假阳性来源)', src: '{{n >= 3}}', expectErrors: 0, }, { name: '反向:多余的闭合标签', src: 'x', expectErrors: 1, }, { name: '反向:标签未闭合', src: 'x', expectErrors: 1, }, ] for (const c of selfCheckCases) { const errors = checkWxml(c.src) assert.equal( errors.length, c.expectErrors, `扫描器自检失败 —— ${c.name}\n期望 ${c.expectErrors} 条错误,实得 ${errors.length} 条:\n${errors.join('\n')}`, ) } // ── 2. 全量扫描小程序页面 ──────────────────────────────────────── // WXML_SCAN_ROOT 仅用于「负向注入自证」:把扫错文件的门禁指向一个临时目录, // 确认它真的会变红。默认扫仓库内 miniapp/。 const scanRoot = resolve(root, process.env.WXML_SCAN_ROOT ?? 'miniapp') const files = walkWxml(scanRoot) assert.ok(files.length > 0, `未在 ${scanRoot} 下找到任何 .wxml —— 扫描清单可能失配,拒绝报绿`) const broken = [] for (const file of files) { const errors = checkWxml(readFileSync(file, 'utf8')) if (errors.length) { broken.push(`${relative(root, file).replace(/\\/g, '/')}\n ${errors.join('\n ')}`) } } assert.deepEqual( broken, [], `以下 WXML 结构不自洽,微信开发者工具会编译失败:\n${broken.join('\n')}`, ) console.log(`WXML structure contracts passed(${files.length} 个文件)`)