vscode插件应通过registerdocumentformattingeditprovider注册格式化服务，优先调用prettier.format而非spawn cli；需校验语言、传入正确fspath、降级处理缺失依赖；eslint校验用eslint.linter.verify并传filepath；注意位置偏移转换、诊断集合管理、大文件节流及跨平台路径规范。
如何在 VSCode 插件中调用 Prettier 或 ESLint 的格式化能力
VSCode 本身不内置代码格式化逻辑，插件需通过 vscode.languages.registerDocumentFormattingEditProvider 注册格式化服务，并实际调用外部工具（如 Prettier）或其 API。直接 spawn prettier CLI 进程容易出错，推荐使用 prettier 包的 format 函数——它更可控、无依赖 shell 环境，且支持同步调用。
关键点：
- 必须在插件激活时检查当前文档语言是否受支持（如
javascript、typescript），避免对不相关文件触发格式化 -
prettier.resolveConfig应传入文档 URI 对应的文件路径（document.uri.fsPath），否则可能读不到项目级.prettierrc - 若用户未安装
prettier依赖，插件需降级处理（例如只返回空数组编辑操作，而非抛异常） - ESLint 校验同理，但应使用
eslint.linter.verify（非 CLI），并注意filePath必须传，否则规则中的overrides和globals可能失效
为什么 registerOnTypeFormattingEditProvider 不生效
这个 API 用于“键入时自动格式化”（如输入 } 后自动补全缩进），但它默认被禁用：VSCode 要求用户显式开启 "editor.formatOnType": true，且插件注册时必须指定 triggerCharacters（如 ['}', ';', '\n']）。更常见问题是触发字符没覆盖真实场景——比如 Vue SFC 中 <script></script> 块内输入 : 想自动加空格，但 : 不在默认 trigger 列表里。
实操建议：
- 不要盲目添加所有标点符号，优先加
['}', ')', ']', ';', '\n']，避免高频误触发 - 对于 HTML 或 Vue 文件，需单独为
html和vue语言分别注册，不能共用一个 provider - 返回的
TextEdit数组必须严格按字符位置升序排列，否则 VSCode 会静默丢弃后续编辑 - 如果格式化结果与用户光标位置冲突（例如自动插入换行导致光标跳到行首），需手动调整
TextEdit.range的 end 位置，避开光标所在行
校验错误如何准确定位到行和列（而非仅显示“Parse error”）
ESLint 和 TypeScript 的 program.getSemanticDiagnostics 返回对象都含 line、column 字段，但它们是基于源码字符串计算的，而 VSCode 的 Position 行号从 0 开始、列号也从 0 开始——这与 ESLint 默认的 1-based 不一致。直接映射会导致提示偏移一行一列。
正确做法：
- 用
vscode.Position(line - 1, column - 1)转换 ESLint 的诊断位置 - 对 TypeScript，
ts.flattenDiagnosticMessageText必须传入""作为 second param，否则多语言环境下可能返回 undefined - 校验结果需通过
vscode.languages.createDiagnosticCollection管理，每次触发前先clear()，再set(uri, diagnostics)，否则旧错误不会消失 - 不要把 warning 当 error 处理：ESLint 的
severity是数字（0=off, 1=warn, 2=error），需映射为vscode.DiagnosticSeverity.Warning或.Error
插件发布后用户报告“格式化卡死”或“校验不触发”
根本原因通常是同步阻塞了主线程。Prettier 的 format 和 ESLint 的 verify 在大文件（>5000 行）下可能耗时数百毫秒，而 VSCode 要求格式化 provider 必须在 1.5 秒内返回，超时则直接终止进程。
缓解方案：
- 对文档长度做前置判断：
document.lineCount > 3000时直接 return []，并用vscode.window.showWarningMessage提示“跳过大文件以保响应性” - 避免在 provider 内部读取
node_modules下的配置文件——改用prettier.resolveConfigFile+ 缓存结果，否则每次格式化都 fs.stat - 校验任务建议节流：监听
vscode.workspace.onDidChangeTextDocument后用setTimeout延迟 300ms 执行，且上一次未完成则 clearTimeout - 绝对不要在插件中
require('eslint')—— 改用createRequire动态加载用户工作区里的eslint，否则版本冲突必然报Cannot find module 'eslint'
最易被忽略的是跨平台路径分隔符：Windows 下 __dirname 含反斜杠，拼接 node_modules/prettier/index.js 时若没 normalize，require 会失败。统一用 path.join(__dirname, 'node_modules', 'prettier', 'index.js')。
