Mpx Oxc

为 Mpx 项目提供代码检查、保存修复和格式化。扩展 ID：lp0124.mpx-oxc。

基于 Oxc VS Code 扩展维护的独立分叉，在原有 TS、JS 等文件支持之外，增加 .mpx 文档接入。检查规则和格式化行为由项目里的工具决定，扩展负责将结果显示在编辑器中。

功能

.mpx、TypeScript、JavaScript 的代码检查、诊断和快速修复。
保存时执行安全修复，支持自动整理 import 等项目已启用的规则。
.mpx 文件格式化；保留 Oxfmt 对 TS、JS、JSON、CSS 等普通文件的支持。
检查与格式化分别显示运行状态、提供日志和重启命令。

类型检查、跳转和补全由 Mpx tsgo 等语言扩展提供；行尾的错误文字可通过 Error Lens 展示。

使用要求

VS Code 1.93.0 或以上，并信任当前工作区。
项目依赖已安装，VS Code 启动的工具进程能够找到 Node.js。
.mpx 检查和格式化需要项目已有的 Mpx 工具适配。 本扩展不包含原生检查器、项目规则或格式化脚本，也不会自动安装它们。仅安装扩展不能让普通 Oxlint / Oxfmt 直接处理 .mpx。
.mpx 的语言模式应为 Mpx，可与 Mpx tsgo 一起使用。

扩展本身未捆绑平台二进制；实际平台范围由项目工具决定。当前团队使用的 Mpx 原生检查器仅支持 macOS 11 及以上、Apple 芯片、arm64 Node.js 20.19.0 及以上，不支持 Rosetta 下的 x64 Node、Intel Mac、Windows 或 Linux。其他项目需核对自身适配工具的支持范围。

安装与配置

在扩展市场搜索 Mpx Oxc，核对发布者 lp0124；也可以从 VSIX 安装。安装后执行 Developer: Reload Window。

已有项目如果提供以下两个 LSP 入口，可在 .vscode/settings.json 中配置：

{
  "files.associations": {
    "*.mpx": "mpx",
  },
  "mpxOxc.path.oxlint": "./scripts/helpers/lint-oxlint-mpx.mjs",
  "mpxOxc.path.oxfmt": "./scripts/helpers/fmt-oxfmt-mpx.mjs",
  "mpxOxc.configPath": "./oxlint.mpx.config.mjs",
  "mpxOxc.fixKind": "safe_fix",
  "editor.formatOnSave": true,
  "editor.defaultFormatter": "lp0124.mpx-oxc",
  "editor.codeActionsOnSave": {
    "source.fixAll.oxc": "always",
  },
  "[mpx]": {
    "editor.defaultFormatter": "lp0124.mpx-oxc",
    "editor.codeActionsOnSave": {
      "source.fixAll.oxc": "always",
    },
  },
}

这些路径是已适配项目的示例，对应文件必须真实存在。其他项目请使用自己的工具入口和配置路径。检查器与格式化器入口需要支持 --lsp，并提供对应的 Mpx 处理能力；扩展不会生成这些文件。

普通 TS / JS 项目也可使用工作区安装的 oxlint 和 oxfmt，无需指定自定义工具入口。需要固定 Node 路径时，在设置中使用 mpxOxc.path.node。

从旧 Oxc 迁移

在当前工作区禁用 Oxc（oxc.oxc-vscode），包括之前以官方名称安装的定制 VSIX，避免两份扩展重复启动服务。
将工作区设置中的 oxc.* 配置项改为 mpxOxc.*，值保持原样。
将所有 editor.defaultFormatter 中的 oxc.oxc-vscode 改为 lp0124.mpx-oxc。注意 [typescript]、[javascript] 等语言专属设置会覆盖全局值。
保留 source.fixAll.oxc。 它是检查服务使用的代码修复类型，不随扩展 ID 改名。如果配置过 source.format.oxc，将它改为 source.format.mpxOxc；仅使用 editor.formatOnSave 时无需增加此项。
在 .vscode/extensions.json 的 recommendations 中将 oxc.oxc-vscode 替换为 lp0124.mpx-oxc，然后重新加载窗口。

扩展不会自动修改工作区设置。安装项目 npm 依赖也不会自动安装本扩展。

排查问题

先查看「问题」面板：有波浪线或诊断但没有行尾文字时，检查 Error Lens 是否启用；完全没有诊断时，先排查检查服务。

在命令面板运行：

Mpx Oxc: Show Output Channel (Linter)：检查依赖、Node 环境和检查服务启动错误。
Mpx Oxc: Show Output Channel (Formatter)：检查格式化服务启动和格式化错误。
Mpx Oxc: Restart oxlint Server / Mpx Oxc: Restart oxfmt Server：重新启动对应服务。
Mpx Oxc: Copy Debug Info：复制版本与配置摘要，反馈前检查内容是否包含需要移除的本机路径。

格式化没有触发时，在 .mpx 文件执行「格式化文档方式…」，确认选中 Mpx Oxc；同时检查保存格式化是否开启，以及语言专属设置是否仍指向旧 Oxc。

来源与许可

本扩展基于 oxc-project/oxc-vscode 1.63.0，保留 MIT 许可和原作者声明。修改包括独立扩展身份、Mpx 文档支持与项目适配入口说明。

本项目由 lp0124 独立维护，与 Oxc、VoidZero 或 Mpx 官方没有隶属关系。许可见市场许可页面，完整第三方声明随扩展包内的 THIRD-PARTY-NOTICES.md 提供。