---
id: system-setting.column-template.howto
title: 列模板（创建项目预置列）
type: howto
feature: system-setting
scope: admin
locale: zh
aliases:
  - 列模板
  - 项目模板
  - 默认看板列
  - 预置列
  - 新建项目选模板
  - 项目预设
  - 看板模板
related_tools: []
related_pages: []
prerequisites:
  - 需要系统管理员权限（普通用户只能 get 读取）
negative:
  - 模板只控制「初始列」，不能预置任务卡、流程、负责人等其他内容
  - 不支持按部门 / 项目分类区分模板
  - 修改模板不会影响已创建项目，仅影响后续新建
  - 保存时空 list 或 list 中没有合法条目会报「参数错误」/「参数为空」
last_verified: v1.7.90
---

# 列模板（创建项目预置列）

## 入口
桌面端：左上角头像 →「系统设置」→「列模板」。
对应后端：`POST api/system/column/template`，`type=get` 读取，`type=save` 写入（限 admin）。

## 是什么
创建新项目时，用户可以从一组预置「列模板」里挑一个直接套用，省去手动建列。模板就是「模板名 + 列名清单」。

例如内置一个「研发任务」模板：
- 列：待办、进行中、待测试、已完成

新建项目时勾选这个模板，项目就自动有这 4 列。

## 字段结构
保存时上传 `list` 数组：

```json
[
  {
    "name": "研发任务",
    "columns": "待办,进行中,待测试,已完成"
  },
  {
    "name": "市场活动",
    "columns": "策划,执行中,复盘"
  }
]
```

- **name** — 模板名（必填）
- **columns** — 逗号分隔的列名字符串，服务端会按 `,` 切分 → 去重 → 去空，落库为数组

任何缺 `name` 或 `columns` 的条目会被服务端跳过；最终为空数组直接报「参数为空」。

## 操作步骤
1. 进入「列模板」页
2. 「新增模板」→ 填写模板名
3. 在列输入框输入列名（多个用逗号分隔）
4. 重复添加多个模板
5. 点击「保存」立即生效

## 与项目创建的关系
用户「新建项目」对话框 →「选择模板」下拉就是这里维护的列表。选某个模板后，项目创建时按列名顺序生成空列，无任务卡。

## 不支持
- 不能模板化「任务流程」、「负责人」、「成员」、「自定义字段」
- 不能跨终端导出/导入模板
- 修改模板不会回溯到已创建的项目（仅对新项目生效）