# @farm\.js/devtools 中文文档

规范地址：https://npmcn.com/package/%40farm.js/devtools/

版本：0\.1\.48
npm 元数据更新时间：2026-11-01T00:42:55.885Z
中文译文更新时间：2026-11-01T03:35:18.049Z
软件包许可：MIT

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

原始 npm 页面：https://www.npmjs.com/package/%40farm.js/devtools
原文对照：https://npmcn.com/package/%40farm.js/devtools/?lang=original
项目主页：https://github.com/farming-labs/farm.js#readme
源码仓库：https://github.com/farming-labs/farm.js

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

- 包体积（解压后）：234 kB，31 个文件
- 模块格式：ES Module
- TypeScript 类型：包内自带
- Node.js 要求：\>=22\.13\.0
- 运行依赖：1 个
- peer 依赖：@farm\.js/core \>=0\.1\.28 \<0\.2\.0
- 首次发布：2026-09-14T19:48:15.647Z
- 最新版本发布：2026-11-01T00:42:55.706Z
- 已发布版本数：58（近 12 个月 58 个）

## 中文简介

用于Farm.js路由、运行时和浏览器模块的开发工作区检查器

## 安装

```sh
npm install @farm.js/devtools
```

也可以使用：`pnpm add @farm.js/devtools`、`yarn add @farm.js/devtools`、`bun add @farm.js/devtools`

## README

# @farm.js / devtools

Farm的官方DevTools：一个仅用于Farm.js路由、api、集成的开发工作区。 运行时诊断和浏览器模块。它取代了已弃用的内置仪表板。使用Farm徽标、捆绑的Geist字体、浅色/深色主题和语法高亮显示 源代码和JSON与安全复制控制。

```ts
import { defineConfig } from "@farm.js/core";
import { devtools } from "@farm.js/devtools";

export default defineConfig({ plugins: [devtools()] });
```

安装与 `pnpm add -D @farm.js/devtools`． 打开左下角的启动器或按 `Command/Ctrl + Shift + .` 在 `farm dev`． UI只在打开时加载。插件是 从生产配置中删除，没有生产客户机或服务器端点。

选项: `launcher?: boolean`， `shortcut?: string | false`， `inspect?: boolean`． 登记 是选择加入；没有 `enabled` 选择。没有插件，应用程序就会退回到 已弃用内置仪表板。不要把它和 `devtools: false`.

插件按插件管理器的执行顺序（pre, normal, post）列出活跃的Farm插件。 带有版本和声明的服务器/客户端钩子名称。它包括声明的遗留钩子名。 这是注册元数据，而不是呼叫跟踪；平行钩可以以不同的顺序完成。 插件配置、公共数据、钩子源和私有状态永远不会序列化。

Inspect将当前应用程序源与Vite缓存的浏览器输出进行比较，而不是单独比较 插件阶段。只有已转换的项目内浏览器源才符合条件；虚拟/服务器仅 模块、依赖项、隐藏路径和外部项目符号链接被排除在外。限制：500个 模块，每个源/输出1 MiB，显示1500行。副本包括完整的有界文本。 当Inspect打开时，所选模块在Vite完成HMR更新后刷新。等待 更新、失败和断开连接将以前显示的代码标记为过时。这重用了应用程序的 Vite连接，不轮询或第二个套接字。其他视图保留了它们的过滤器和选择； 对它们的最新快照使用Refresh。重新加载整个页面会关闭应用程序的面板。

DevTools是只读的，不是公共开发服务器的身份验证边界。环境 快照中没有值；客户端源中的文字不会被编辑。保持发展 私人服务器。资产和高亮显示是本地的，没有CDN调用。

完整的文档: [https://farmjs.dev/docs/plugins/devtools](https://farmjs.dev/docs/plugins/devtools)

这个包是独立的版本，由工作空间build， test, packing， 以及发布脚本。不会自动添加启动器依赖项。

## 常见问题

### @farm\.js/devtools 是什么？

用于Farm\.js路由、运行时和浏览器模块的开发工作区检查器

### 如何安装 @farm\.js/devtools？

在项目目录运行 npm install @farm\.js/devtools，或使用 pnpm add / yarn add / bun add。它还需要宿主项目提供 peer 依赖：@farm\.js/core（\>=0\.1\.28 \<0\.2\.0）。npm 7 及以上与 pnpm 8 及以上默认会自动安装必需的 peer 依赖，Yarn 需要手动安装。

### @farm\.js/devtools 支持 TypeScript 吗？

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

### @farm\.js/devtools 支持 ESM 还是 CommonJS？

以 ES Module 形式发布，推荐使用 import 引入。在 CommonJS 项目中，Node\.js 20\.19\+ / 22\.12\+ 可以直接 require\(\) 不含顶层 await 的 ES Module，更早的版本需要改用动态 import\(\)。

### @farm\.js/devtools 需要什么版本的 Node\.js？

package\.json 的 engines 字段要求 Node\.js \>=22\.13\.0。版本不符时 npm 默认只给出警告，开启 engine-strict 后会拒绝安装。

### @farm\.js/devtools 可以商用吗？

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

### @farm\.js/devtools 还在维护吗？

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