# @fluixi/ts-plugin 中文文档

规范地址：https://npmcn.com/package/%40fluixi/ts-plugin/

版本：1\.0\.0-alpha\.108
npm 元数据更新时间：2026-11-07T01:12:09.858Z
中文译文更新时间：2026-11-15T03:17:15.128Z
软件包许可：MIT

本文由上游 README 翻译，可能存在偏差，请结合原文核对 API、命令与配置。版权与许可归原作者所有。

原始 npm 页面：https://www.npmjs.com/package/%40fluixi/ts-plugin
原文对照：https://npmcn.com/package/%40fluixi/ts-plugin/?lang=original
项目主页：https://github.com/fluixi/core#readme
源码仓库：https://github.com/fluixi/core

## 关键信息（来自 npm 元数据）

- 包体积（解压后）：186 kB，34 个文件
- 模块格式：CommonJS
- TypeScript 类型：包内自带
- 运行依赖：2 个
- 首次发布：2026-07-13T05:54:29.664Z
- 最新版本发布：2026-11-07T01:08:45.079Z
- 近 30 天下载量：2329（2026-10-15 至 2026-11-13，npm 官方下载统计）
- 已发布版本数：42（近 12 个月 42 个）

## 中文简介

给 html " 模板, 编辑器支持 JSX 已经获得; 仅作为标签使用的组件不再报告为未使用

## 安装

```sh
npm install @fluixi/ts-plugin
```

也可以使用：`pnpm add @fluixi/ts-plugin`、`yarn add @fluixi/ts-plugin`、`bun add @fluixi/ts-plugin`

## README

# @fluixi/ts-plugin (英语)

TypeScript 语言服务插件 `` html`...` `` 模板相同的编辑器 支持JSX获得.

## 问题

TypeScript 将标签模板视为不透明字符串 。 里面的东西都掉下来了 映射: 仅通过标签引用的组件被报告为“ 已声明但从未使用 ” , 回调 parm是隐含的 `any`没有什么是完整的,徘徊什么也没有说,去定义 放在模板文字上而不是组件上.

```ts
function UserCard() { /* … */ }

const app = html`<main><UserCard /></main>`;
//                      ^ greyed out — TypeScript never counted this as a reference
```

写入 `html` 不应该浪费你的编辑.

## 你得到的东西

以 [`@fluixi/template-parser`](https://npmcn.com/package/%40fluixi/template-parser),绘制每个标签和 洞回到真正的源位置,并询问程序自己的检查器对此:

-   **缓冲**: 组件标记显示其签名,道具显示其声明的类型, an 元素属性显示它需要什么,并推断出召回参数(`each`, (中文(简体) ), `event`, (中文(简体) ), `ref`, (中文(简体) ), `use`, (中文(简体) ), `Show`)显示它所推断的类型.
-   **完成**: 标记内的组件道具名称, 内在的元素属性 标记,以及推定参数的成员(`it.`, (中文(简体) ), `el.`, (中文(简体) ), `e.`) (中文(简体) ).
-   **导航**:去定义,查找所有参考,并通过标记重命名工作. 重命名只当 TypeScript 自己的重命名成功时添加了标签, 所以您永远不会得到一个 重写 `<Tag>` 与一个 stale `</Tag>`。 。 。 .
-   **诊断**: 模板中的赤色存取器(`` html`<p>${count}</p>` ``有标记, 因为它使功能一次更新,永远不更新; 一个不存在于一个 报告推定的参数.
-   **安静点**:未使用组成部分报告和隐含`any` 参数上的噪音 模板可以推断为已删除.
-   **快速修正**:"呼吁 `count`" 对于一个赤裸的存取器,有一个整齐的文件.

## 打开它

把它加入你的项目 `tsconfig.json` 并使用 **工作空间** 类型脚本版本 (VS代码: `TypeScript: Select TypeScript Version → Use Workspace Version`: tsconfig 插件 只在工作空间 TS 下装入 :

```jsonc
{
  "compilerOptions": {
    "plugins": [{ "name": "@fluixi/ts-plugin" }]
  }
}
```

没有别的事了 JSX 不需要插件, 也不需要插件 `$signal`\- 风格内在: 键入 `fluixi.d.ts` 编译器生成.

## 如何不碍事

一切都在计算 **现有** 程序检查器。 该插件没有创建语言 服务,不添加文件,也绝不接触主机:它包接它交给的服务 每一个加法都被包了起来 所以失败的代价是额外的信息 而不是真正的答案.

这种克制是蓄意的。 内部进行深层类型检查的两个早期设计 `${...}` 孔头 两人都得走: 一秒钟 `ts.LanguageService` 指第二个文件注册,所以 lib.d.ts 和节点模块进行了两次解析;并通过 `getScriptFileNames` 重新输入 每个项目同步上的主机,语言服务全然崩溃。 洞层 诊断也不值得: `${...}` 孔是一个真实的表达式, 所以 TypeScript 已经 检查它.

## 许可证

麻省理工学院

## 常见问题

### @fluixi/ts-plugin 是什么？

给 html " 模板, 编辑器支持 JSX 已经获得; 仅作为标签使用的组件不再报告为未使用

### 如何安装 @fluixi/ts-plugin？

在项目目录运行 npm install @fluixi/ts-plugin，或使用 pnpm add / yarn add / bun add。

### @fluixi/ts-plugin 支持 TypeScript 吗？

支持。包内自带 TypeScript 类型声明（package\.json 声明了 types 入口），安装后即可获得类型提示，无需再安装 @types 包。

### @fluixi/ts-plugin 支持 ESM 还是 CommonJS？

以 CommonJS 形式发布，可以直接 require\(\)；在 ES Module 项目中也可以用 import 引入（Node\.js 会把 module\.exports 作为默认导出）。

### @fluixi/ts-plugin 可以商用吗？

@fluixi/ts-plugin 使用 MIT 许可。宽松许可：允许商业使用、修改和再分发，通常只需在分发时保留原版权与许可声明。以上为概括，不构成法律意见，请以许可原文为准。

### @fluixi/ts-plugin 的下载量有多少？

根据 npm 官方下载统计，@fluixi/ts-plugin 在 2026/10/15 – 2026/11/13 这 30 天内被下载 2,329 次，日均约 78 次。下载量会把 CI 构建、镜像同步和作为其他包依赖的安装一并计入，适合横向比较热度，不能直接等同于使用人数。

### @fluixi/ts-plugin 还在维护吗？

最新版本 1\.0\.0-alpha\.108 发布于 2026/11/07（8 天前）；至今共发布 42 个版本，其中过去 12 个月发布了 42 个；首次发布于 2026/07/13。发布频率只是参考信号：功能稳定的工具可能很少需要更新，建议结合源码仓库的 issue 和提交记录判断。