用途:hygiene 用于在提交前确保代码通过 VS Code 的卫生检查(hygiene checks)。VS Code 将卫生检查作为 git pre-commit 钩子运行,检查不通过则提交被拒绝。
主要能力:卫生检查 linter 扫描暂存文件,检查项包括但不限于:非 ASCII 字符(如 em-dash、弯引号、emoji)被拒绝,需在注释和代码中使用 ASCII 等价写法;双引号仅用于外部化(本地化)字符串,其余场合使用单引号;所有文件必须包含 Microsoft 版权头;缩进只用制表符,不用空格;TypeScript 文件必须匹配格式化器输出;TypeScript 文件经 ESLint 检查;CSS 文件经 stylelint 检查。
使用方式:完成工作前应始终运行该检查。对暂存文件运行:npm run precommit,它执行 node --experimental-strip-types build/hygiene.ts,仅扫描暂存文件(来自 git diff --cached)。直接检查指定文件(无需先暂存):node --experimental-strip-types build/hygiene.ts path/to/file.ts。
抑制方式:可用 // allow-any-unicode-next-line 或 // allow-any-unicode-comment-file 绕过 Unicode 限制。
限制:资料未提供更多检查项、配置项、适用版本或性能信息,暂未提供。