---
title: 项目设置元数据
description: 项目设置文件阅读入口，指向项目基本信息、数据源范围、显示格式、国际化和项目级存储配置的 DTS 说明
navTitle: 项目设置
---
# 项目设置元数据

项目设置位于普通元数据项目的 `settings/settings.json`，例如 `/项目名称/settings/settings.json`，定义单个元数据项目的运行边界。它决定当前项目能使用哪些系统数据源和文件存储，哪些显示格式和语言资源在项目内可用，以及分析、表单、数据治理等模块在当前项目中的默认行为。

当配置只影响某个普通项目，而不是整个部署环境或某个单独 app 应用时，应维护项目设置。系统级安全、登录、域名、路由和全局运维能力放在 [系统设置](./sys-settings-json.md)（`sysdata/settings/settings.json`）；应用首页、应用路由和应用级覆盖项放在 [应用设置](./app-settings-json.md)（`xxxx.app/settings.json`）。

此文件只描述普通项目的项目级设置，不描述 `sysdata/settings/settings.json`。

## 配置边界{#config-boundary}

- 数据源范围描述“当前项目可以使用哪些系统数据源”，真正的连接配置在 `sysdata/data/sources/*.jdbc`。
- 显示格式和国际化配置是项目级默认能力，应用内仍可以通过应用设置做覆盖。
- `dataFileBuckets` 和 `attachmentsBuckets` 使用项目内别名引用系统级文件存储，影响数据加工文件和模型附件字段。
- 部分项目级设置存在产品默认值，缺省字段不等于空对象。

## DTS 入口{#types}

- 根结构：[`types/meta/file-types/project-settings.d.ts`](../../../../../dev-types/types/meta/file-types/project-settings.d.ts)
- 文件类型入口：[`types/meta/file-types/index.d.ts`](../../../../../dev-types/types/meta/file-types/index.d.ts)
- 显示格式：[`types/meta/common/displayformat.d.ts`](../../../../../dev-types/types/meta/common/displayformat.d.ts)
- 国际化配置：[`types/meta/common/i18n.d.ts`](../../../../../dev-types/types/meta/common/i18n.d.ts)