signalr-comment-fixer

一个 Vite 插件，用于消除构建 @microsoft/signalr 时出现的 /*#__PURE__*/ 注释警告。

安装

npm install @aurouscia/signalr-comment-fixer --save-dev

pnpm add -D @aurouscia/signalr-comment-fixer

问题背景

使用 Vite/Rollup 构建依赖 @microsoft/signalr 的项目时，可能会遇到如下警告：

A comment "/*#__PURE__*/" contains an annotation that Rollup cannot interpret due to the position of the comment. The comment will be removed to avoid issues.

该警告不会影响构建结果，但会在每次构建时刷屏。其原因是 @microsoft/signalr 的部分代码把 /*#__PURE__*/ 注释放在了函数声明之前，而 Rollup 无法识别这种位置的注解。

本插件会在 transform 阶段自动处理 @microsoft/signalr 模块，移除函数声明前的 /*#__PURE__*/ 注释，从而避免警告。

使用

在 vite.config.ts 中引入并注册插件：

import { defineConfig } from 'vite'
import { signalrCommentFixerPlugin } from '@aurouscia/signalr-comment-fixer'

export default defineConfig({
  plugins: [
    signalrCommentFixerPlugin()
  ]
})

API 参考

signalrCommentFixerPlugin()

返回一个 Vite 插件对象。

function signalrCommentFixerPlugin(): Plugin

| 属性 | 值 | 说明 | |------|-----|------| | name | 'signalr-comment-fixer' | 插件名称 | | enforce | 'pre' | 确保插件尽早执行 |

实现细节

• 插件通过 transform 钩子处理模块代码。
• 仅对路径中包含 @microsoft/signalr 的模块生效。
• 使用正则表达式移除函数声明前的 /*#__PURE__*/ 注释，不影响其他代码或注释。

注意事项

• 本插件仅用于消除构建警告，不会修改 @microsoft/signalr 的运行时行为。
• 如果 @microsoft/signalr 在后续版本中修复了该注释位置问题，可以移除本插件。