# @adobe/cc-ext-uxp-types 中文文档

规范地址：https://npmcn.com/package/%40adobe/cc-ext-uxp-types/

版本：7\.3\.1
npm 元数据更新时间：2026-10-01T01:32:44.876Z
中文译文更新时间：2026-11-05T21:07:16.648Z
软件包许可：未声明

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

原始 npm 页面：https://www.npmjs.com/package/%40adobe/cc-ext-uxp-types
原文对照：https://npmcn.com/package/%40adobe/cc-ext-uxp-types/?lang=original
项目主页：https://github.com/adobe/cc-ext-uxp-types#readme
源码仓库：https://github.com/adobe/cc-ext-uxp-types

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

- 包体积（解压后）：484 kB，6 个文件
- TypeScript 类型：未声明
- 运行依赖：0 个
- 首次发布：2023-10-13T16:06:09.977Z
- 最新版本发布：2023-10-19T10:25:19.937Z
- 近 30 天下载量：20991（2026-10-05 至 2026-11-03，npm 官方下载统计）
- 已发布版本数：2（近 12 个月 0 个）

## 中文简介

Adobe UXP JS API的打字定义

## 安装

```sh
npm install @adobe/cc-ext-uxp-types
```

也可以使用：`pnpm add @adobe/cc-ext-uxp-types`、`yarn add @adobe/cc-ext-uxp-types`、`bun add @adobe/cc-ext-uxp-types`

## README

## cc-ext-uxp 类型

Adobe UXP(统一扩展平台)的类型定义.

**UXP( 统一扩展平台)** 由现代JavaScript引擎提供动力,提供UI组件的全程选择和更简化的工作流程供插件开发者为UXP驱动主机应用程序(如Adobe Photoshop,Adobe InDesign和Adobe XD)构建插件. UXP提供了一组常见的JavaScript API,这些主机应用程序中可以提供,并且这些常见的UXP JavaScript API在此repo中可以使用的类型. 这些类型是使用UXP代码库内部的脚本自动生成的.

**说明**: 主机应用程序的类型定义,条件是JavaScript API在单独的repo中存在,需要单独安装.

### 安装

如何下载/安装 UXP 类型定义到您的机器上的指示 .

示例

```
npm install @adobe/cc-ext-uxp-types
```

### 配置

对于在代码编辑器中使用UXP类型定义,需要创建 tsconfig. json 在您的打字框中添加引用编译器选项中的类型声明.  
为了确保UXP类型与现有的网络标准DOM类型不相冲突,更新所需的lib选项以排除这些标准类型. (参考: [https://www.typescriptlang.org/tsconfig#lib 互联网档案馆的存檔,存档日期2013-12-21](https://www.typescriptlang.org/tsconfig#lib)(中文(简体) )  
注意: 请为 JavaScript 工程使用 jsconfig.json  

ts/jsconfig.json (英语:

```
{
  "compilerOptions": {
     ..., // your existing configuration 
    // typeRoots override defaults, so be sure to include the implicit @types as well
    "typeRoots": [
      "node_modules/@types",
      "node_modules/@adobe/cc-ext-uxp-types"
    ],
    // Note that "DOM" is not included in lib options to exclude web DOM types
    "lib": ["ES2015"] // required ES version
  }
}
```

一旦设置了配置,您就可以对类型建议、 API 使用和信息、 自动导入等类型定义施加杠杆作用

### 已知问题

-   UXP代码主要用JavaScript来写出,并非类型定义中的所有参数都与准确类型一起明确指定. 因此,你可能会遇到一些参数的"任何"类型.
-   目前还没有关于一些UXP支持的全局的类型定义,例如"窗口","导航".  
    请参看 [UXP 文档](https://developer.adobe.com/photoshop/uxp/2022/uxp-api/) 用于现有类型.
-   继承属性显示 eg 的衍生类而非基类名称( 内部库中已知的问题正在使用)

```
 const document = new Document();
 document.isConnected();
```

类型信息将显示 `isConnected` 作为 `Document` (继承)而不是基础类 `Node` 在这里.

-   当元素与文档一起创建时, Typedef API 建议将不会出现 。 创建 Element API 用于 :

```
const img = document.createElement("img");
```

`img` 将不会按照当前限制显示预期的类型建议. 然而,通过下列构造器创建的元素将显示预期的正确类型:

```
const imgElement = new HTMLImageElement();
```

请注意,我们将逐步改进类型定义,并增加UXP API的准确类型以及上述一些问题. 如果你遇到任何问题或有改进建议,请随意报告,作为问题.

### 许可证发放

见 [自由主义](https://npmcn.com/package/%40adobe/cc-ext-uxp-types/LICENSE) 更多信息.

## 常见问题

### @adobe/cc-ext-uxp-types 是什么？

Adobe UXP JS API的打字定义

### 如何安装 @adobe/cc-ext-uxp-types？

在项目目录运行 npm install @adobe/cc-ext-uxp-types，或使用 pnpm add / yarn add / bun add。

### @adobe/cc-ext-uxp-types 支持 TypeScript 吗？

该包的 package\.json 没有声明类型入口。需要类型提示时，可以在 npm 上查找社区维护的 @types/adobe\_\_cc-ext-uxp-types 是否存在。

### @adobe/cc-ext-uxp-types 可以商用吗？

@adobe/cc-ext-uxp-types 使用 未声明 许可。package\.json 没有声明许可证。没有许可证的代码默认保留全部权利，商用前请联系作者或查看仓库中的 LICENSE 文件。以上为概括，不构成法律意见，请以许可原文为准。

### @adobe/cc-ext-uxp-types 的下载量有多少？

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

### @adobe/cc-ext-uxp-types 还在维护吗？

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