技能介绍

要解决什么问题

在一个仓库里同时维护 TS、JSON、Markdown、TOML、CSS 等多种文件时，格式化工具往往是一堆拼不起来的散件：每个语言一套配置，CI 上跑的格式检查和本地编辑器保存时的行为还可能不一致，diff 里全是换行和缩进噪音。dprint 的目标就是把这些分散的格式化动作收敛到一个 CLI 上，让「保存即格式化」和「CI 检查」使用同一套规则。

它是怎么工作的

统一入口：一个命令行工具覆盖 TypeScript、JavaScript、JSON、Markdown、TOML、CSS、HTML、Dockerfile 等常见文件类型，不再为每种语言单独装一套 formatter。
插件化架构：核心本身是精简的调度层，具体语言的格式化能力由插件提供。插件以 Wasm 形式加载，因此多个插件可以跑在同一个运行时里，也避免了为每种语言编译原生依赖的负担。
配置驱动：通过项目根目录的配置文件声明要启用哪些插件、每类文件用什么规则，规则可以按项目甚至按目录调整，团队内所有人拿到的格式结果一致。
可扩展：需要新增一种语言或换一个规则集时，只要有一个对应的插件就能接进来，核心不需要改动。

适用边界与注意点

它解决的是格式一致性问题，不是 lint：缩进、引号、行宽、换行策略这类风格规则适合交给它，语义层面的代码质量问题仍需要另外的检查工具。
插件能力依赖上游生态。例如 dprint-plugin-ruff 是对 Ruff 的包装，用它来格式化 Python 时，实际规则仍来自 Ruff，参数和版本要对齐上游文档，出现行为差异时优先去查对应插件的说明。
Wasm 插件在不同 Node 版本和 CI 镜像里的表现可能有细微差别，锁定 Node 版本和 CI 基础镜像有助于得到可复现的结果。