检查文本中的字符能否用目标编码原样保存。无法保留的字符会高亮，并出现在 VS Code 的“问题”面板中。扩展只检查文本，不修改文件。
例如，日文通常可以用 Shift JIS 保存，emoji 则不能。即使字符可以写出字节，只要解码后变成其他字符，也会报告问题。
要求 VS Code 1.146 或更新版本。支持桌面版和远程扩展宿主。
安装扩展后打开文本文件。默认跟随文档的实际保存编码，切换文件、编辑内容或更改编码后自动检查。状态栏显示目标编码和问题字符数。
若要检查文件能否转换为另一种编码，在设置中指定目标：
{
"codepageValidator.encoding": "shiftjis"
}设为 auto 可恢复跟随文档编码。此功能使用 VS Code 的正式 TextDocument.encoding API。
| 设置 | 默认值 | 含义 |
|---|---|---|
codepageValidator.encoding |
auto |
文档编码，或 iconv-lite 支持的目标编码名 |
codepageValidator.liveValidation |
true |
自动检查可见文档 |
设置支持工作区和文件夹覆盖，修改后立即生效。关闭自动检查后，可运行 Codepage Validator: Validate Current File 或点击状态栏手动检查。再次编辑会清除旧结果。
通过 VS Code 的 Install from VSIX... 安装本地构建的安装包。
校验器逐个读取 Unicode 字符，执行“编码 → 解码”，再与原字符比较。相同字符在一次扫描中只转换一次。结果记录 UTF-16 偏移，与 VS Code 的文本位置一致，因此 emoji 会作为完整字符标记。
编码逻辑不依赖 VS Code。扩展层负责读取文档和设置、发布诊断、高亮字符，以及管理事件和资源。连续编辑合并为一次检查，延迟为 150 毫秒。
扩展不推测文件的原始编码、不修复乱码，也不检查字体字形。每次检查仍扫描全文，大型文件可关闭自动检查。UTF-8 BOM 按 UTF-8 字符集校验，正文中的 U+FEFF 会保留。
使用 Node.js 24 或更新版本。
npm ci
npm test
npm run test:integration
npm run packagenpm test 执行严格类型检查和算法测试。集成测试在隔离的 VS Code 1.146.0 扩展宿主中验证诊断、编辑事件、设置和多编辑器行为，首次运行需下载安装包。
npm run watch 持续构建。按 F5 启动调试宿主。npm run package 生成 codepage-validator-1.0.0.vsix，内含打包后的扩展代码及许可证。
| 路径 | 内容 |
|---|---|
src/encoding.ts |
与编辑器无关的编码校验算法 |
src/extension.ts |
VS Code 接入与生命周期管理 |
tests/unit/ |
编码算法测试 |
tests/host/ |
真实扩展宿主测试 |
scripts/build.mjs |
esbuild 构建入口 |
锁文件固定安装版本。打包工具的 minimatch 使用 ^11.0.1 覆盖，修复 GHSA-g3hv-75wg-m249；上游升级后可移除此覆盖。