项目配置体检
Config Audit — tsconfig / vite / package.json / .env / Dockerfile
已复制 ✓
粘贴任意一种配置后点击体检;识别不中可手动选择类型
说明
- 一个页面体检五种配置:自动识别类型(识别结果在执行前回显,可改选),手动选择永远最优先。
- 体检为静态规则检查:不执行代码、不做语法解析外的任何求值;结果分级 warn = 建议尽快处理,info = 结合项目场景确认。
tsconfig.json
- 支持 JSONC:
//与/* */注释、对象/数组尾逗号;仍解析失败才报 PARSE_ERROR(附行号)。 - 体检项:target 过旧(TS_TARGET_OLD)、strict 关闭但子开关开启(TS_STRICT_SUBSWITCH)、moduleResolution 过时(TS_MODULERESOLUTION_MODERN)、未知键(TS_UNKNOWN_KEY)。
vite.config
- 静态规则体检:纯正则/文本规则,不执行代码、零 eval、零依赖。
- 体检项:proxy 缺 changeOrigin(V_PROXY_CHANGEORIGIN)、alias 根绝对路径不可移植(V_ALIAS_ABSOLUTE——
'@':'/src'触发、'@':'./src'不触发)、outDir 指向 public(V_OUTDIR_PUBLIC)、plugins 空数组(V_PLUGINS_EMPTY)、module.exports 的 CJS 迹象(V_CJS_HINT)。
package.json
- 严格 JSON.parse(无注释容错),解析失败报 PARSE_ERROR 并附行号。
- 体检项:name 命名规范(PKG_NAME)、^0.x 语义陷阱(PKG_CARET_ZERO)、dependencies 与 devDependencies 重复(PKG_DUP_DEP)、license 缺失或非 SPDX 形状(PKG_LICENSE)——消息均带具体键名。
.env
- 查重复键(ENV_DUP)、空值(ENV_EMPTY)、弱密钥(ENV_WEAK_SECRET);再粘 .env.example 后追加缺失 / 多余键对比(ENV_MISSING / ENV_EXTRA)。
- 自动标注值类型(number / boolean / url / string),标注列随结果给出。
- 解析容错:
export前缀、成对引号剥离、CRLF 行尾、KEY = V键值空格;# 注释行跳过。
Dockerfile
- 逐行指令切词(FROM / RUN / ENV / ADD / COPY / USER / CMD 等,大小写不敏感,支持
\续行),静态审计不执行任何命令。 - 体检项:FROM 无 tag / :latest(DK_FROM_LATEST)、ENV 明文密钥(DK_SECRET_ENV)、本地路径用 ADD(DK_ADD_LOCAL)、apt 安装不清缓存(DK_APT_CACHE)、全文无 USER(DK_ROOT_USER)、依赖清单层序(DK_LAYER_ORDER——仅当存在依赖清单 COPY 且整目录 COPY/ADD 先于它才触发)。
使用指南
让 AI 生成项目配置越来越常见,但生成物能不能直接用常要打问号。配置体检支持五类文件:tsconfig、vite 配置、package.json、.env 与 Dockerfile,粘贴后自动识别类型,逐条指出常见问题并附修改建议。不需要先弄清每条规则的出处,按提示逐项核对即可。新项目初始化、接手老项目,或核对 AI 给出的配置时,都值得先跑一遍。
常见问题
- 能识别哪几种配置文件?
- 五种:tsconfig、vite 配置、package.json、.env 与 Dockerfile。粘贴后自动识别类型,识别不准时可手动指定,再逐条体检并给出建议。
- 体检结果能替代人工评审吗?
- 不能。它覆盖的是常见高危项与口径问题,适合快速过一遍;上线前的关键配置仍建议结合团队规范做人工复核。