简介
在 Odoo 的数据模型中，Char 字段是最常见的文本字段类型之一。无论是联系人姓名、商品编码，还是销售订单上的备注，很多界面中看到的单行文本输入都是靠 Char 字段来存储的。
无论你是使用 Odoo Studio 配置表单的业务用户、编写自定义模块的开发者，还是为客户设计系统的顾问，理解 Char 字段的特性都会帮助你更稳妥地设计数据结构并避免常见问题。
表面看上去很简单，但 Char 字段有多个关键属性和行为值得了解：它在数据库里如何映射、在界面上如何呈现、如何与索引和翻译配合使用等。本指南将逐步讲清这些要点，并结合实际业务场景给出可操作建议。
什么是 Odoo 中的 Char 字段
在 Odoo 的 ORM 层，Char 字段用于保存短小的字符串。根据是否指定长度限制，它会映射为 PostgreSQL 中的 VARCHAR 或 TEXT 列。
对终端用户来说，Char 字段通常在表单中以单行文本框呈现，在列表视图中以纯文本列显示。它适合用来保存名称、编码、引用号、标识符等单行信息。
在模型定义中，你会用 Python 来声明这种字段，例如用 fields.Char 来创建一个单行文本字段。
示例：在自定义模型里用 fields.Char 声明一个客户采购单引用字段（示例代码节省展示，仅示意如何在模型中声明）。
常见的配置项包括字段标签（界面显示名）、长度限制（可选）以及是否建索引等，这些设置影响用户体验和数据库行为。
通过 Odoo Studio 创建的单行文本在界面上称为 Text（single line），并且系统会自动为其生成 x_studio_ 前缀；通过代码或 API 创建时则由开发者自行命名。
字段的工作原理
当你在模型里定义 Char 字段后，Odoo 在模块安装或升级时会自动在数据库中创建对应列，一般不需要手写 SQL 迁移。
如果没有指定 size，Char 字段在数据库中通常使用 TEXT 类型；指定了 size 则使用 VARCHAR(n)。PostgreSQL 对两者都能高效处理，因此更多是用于控制长度而非性能优化。
关键字段属性一览
下面列出 Char 字段最常用且影响显著的属性，便于在设计时快速参考。
- size：用于限定最大字符数。未设置则数据库层面不限制长度，应在能预见最大长度时明确设置。
- translate：若设为 True，可对该字段的内容进行多语言翻译，适用于面向不同语种用户的文本字段。
- required：将字段设为必填，既影响界面校验也影响模型层级的数据完整性。
- default：定义新记录时的默认值，能提升录入效率并减少空值。
- index：为该列创建数据库索引，加速按该字段过滤或搜索。
- compute：关联一个 Python 计算方法，用于生成派生值或拼接字符串等场景。
- store：配合 compute 使用，决定计算结果是否持久化存储到数据库。
- copy：控制复制记录时该字段是否被复制，默认 True，某些标识类字段常设为 False。
在视图中的呈现方式
在表单视图中，Char 字段渲染为标准的单行输入框；在列表视图中显示为纯文本；在搜索视图中可自然支持包含、等于和以...开头等过滤方式。
可以在视图中为 Char 字段指定 widget 来改变展示或交互，例如 email widget 将其变为可点击的邮件链接，url widget 则支持在新标签页打开。
与 Odoo ORM 的交互
开发者读写 Char 字段与其他字段类似：直接通过 record.field_name 访问，框架会基于字段定义执行基本校验与清洗，不涉及复杂的自动转换，这使得 Char 字段在开发中非常方便。
业务场景举例
Char 字段贯穿于 Odoo 的多数业务模块，下面列出五个常见的真实业务用例，展示它们如何帮助工作流更顺畅。
CRM：客户内部编码
许多企业会给客户分配内部编码以便快速检索。在 res.partner 上使用 Char 字段保存客户编码，可以在客户列表、销售订单和发票中一致显示并被检索，避免客户名相似时的混淆。
销售：客户采购单号
客户下单时会带上采购单号，这个号需要体现在发票和交付单上。sale.order 中的 client_order_ref 就是 Char 字段；它能在单据间传递，减少因缺少引用导致的沟通来回。
库存：物料内部编号
product.template 上的 default_code 是一个典型的 Char 字段，用来保存内部料号，供仓库、条码设备和采购单使用。保持该字段整洁一致是库存数据治理的重点之一。
会计：税号和登记号
增值税号、税务登记号等通常以 Char 字段存在于 partner 上，配置正确后会自动出现在客户发票或供应商账单上，跨国业务中集中保存这些信息能大幅降低手工纠错成本。
人力资源：员工编号与卡号
HR 常需要保存员工的工号、门禁卡号或第三方薪资系统的标识。把这些标识放在 employee 模型的 Char 字段里，能方便与其他系统或设备做匹配，即便暂时不做深度集成也能满足日常需求。
如何创建或自定义 Char 字段
添加 Char 字段的三种主要方式
根据你的技术背景和交付流程，可以通过 Odoo Studio、编写自定义模块或调用 API 创建 Char 字段。每种方法适用于不同场景。
通过 Odoo Studio（无代码）
- Odoo Studio 是内置的低代码/无代码定制工具，适合业务人员在不改代码的情况下快速扩展表单。
- 打开 Odoo Studio 并进入需要修改的表单页面。
- 从侧栏拖放一个单行 Text 字段到表单上。
- 在字段属性里设置标签、是否必填以及可选的长度限制。
- 保存并关闭 Studio，系统会自动创建字段和视图的关联。
通过 Studio 创建的字段会带有 x_studio_ 前缀并自动生效，无需手动做数据库迁移。
通过 Python 在自定义模块中添加（推荐用于可控部署）
开发者在模块中用 Python 定义 fields.Char 是更可维护且适合版本控制的做法，适合需要跨环境部署的自定义项。
示例：在 res.partner 上添加自定义 ERP 客户 ID 字段（示意性代码），并设置长度、索引与复制行为。
在模型声明后，还需在对应的视图 XML 中把字段加入界面。安装或升级模块时，Odoo 会在数据库中自动创建所需的列。
通过 XML-RPC API（编程式管理）
如果你在自动化部署或远程配置脚本中管理字段，可通过 XML-RPC API 动态创建 Char 字段。
示例：通过 models.execute_kw 调用 ir.model.fields.create 来新建一个 ttype 为 'char' 的字段（示例用于说明 API 创建字段的思路）。
在 API 或 Studio 创建的字段应把 state 设置为 manual，表明此字段并非由模块文件定义，而是手动创建或外部脚本生成。
最佳实践建议
实用建议 1：在能预见最大长度时设置 size
若字段仅用于固定长度的数据（如国家代码、电话号码格式化、固定标识符），应设置 size。明确长度有助于约束数据质量，避免用户误输入超长内容。
实用建议 2：对常用查询字段建立索引
若用户经常按该字段搜索或筛选（如客户编码、订单号），在字段定义中加上 index=True。大数据量表上索引能显著提升查询响应速度。
实用建议 3：面向多语言的字段启用 translate
如果系统面对不同语种用户，且字段内容需要按语言显示（如产品名、职位名称等），应开启 translate=True，以便在不同语言环境下显示合适的文本。
实用建议 4：使用清晰一致的技术名
在自定义模块中给字段起有意义的技术名（例如 x_customer_erp_id），比 x_field1 更容易维护。通过 Studio 创建时，尽早在属性里修改技术名，避免后续改名困难。
实用建议 5：对派生引用使用 compute
对于需要由其他字段拼接或计算得来的引用，可以用 compute 方法生成 Char 值，并配合 store=True 持久化，既保持逻辑集中又支持搜索和报表。
常见错误与陷阱
常见陷阱 1：不设长度可能导致数据混乱
没有 size 限制时，用户可能粘贴长段文字到本应为简短引用的字段中，导致打印单据或对接外部系统时超长报错。能预估长度的字段应设合理上限。
常见陷阱 2：缺少索引影响查询性能
如果经常以某个 Char 字段做筛选但没有索引，随着数据增长查询会变慢，很多团队在系统上线后才发现这一性能瓶颈。建议在设计时评估常用筛选字段并添加索引。
常见陷阱 3：混淆 Char 与 Text 字段用途
Char 适合单行短文本，Text 才适合多行长文本。把地址或描述放到 Char 字段会影响录入体验（无法换行），也可能限制后续显示和导出。
常见陷阱 4：多语言字段忘记启用翻译
面向跨地域客户的字段若未设置 translate=True，将导致所有语言用户看到相同文本，影响面向客户的单据展示与用户体验。
常见陷阱 5：把固定枚举或关联当成 Char 存储
如果字段只会取一组受限值（如状态、类别或国家），应使用 Selection 或 Many2one，而不是自由文本的 Char。字符字段容易出现拼写不一致，影响统计和分组分析。
常见问题解答（FAQ）
Char 字段和 Text 字段有什么区别？
Char 用于单行短文本、表单中表现为单行输入；Text 用于多行长文本、表现为可调大小的 textarea。名称、编码用 Char；描述、备注用 Text。
我可以限制 Char 字段的字符数吗？
可以。在 Python 定义字段时使用 size 参数，例如 fields.Char(size=64)。在 Odoo Studio 中也可在字段属性里设置长度限制。不设置则数据库层面不强制长度上限。
如何让 Char 字段出现在搜索栏中？
Add the field to the search view of the model. In Studio, enable the search option in the field properties. In code, add <field name="your_char_field"/> inside the <search> view definition in your XML. Once added, users can filter records by that field directly from the search bar.
能把数字存到 Char 字段吗？
技术上可以，但若需进行数值运算或比较，应使用 Integer/Float。Char 更适合像邮编、电话、IBAN 或序列号这类以文本形式处理的数字串。
如何创建既是 compute 又持久化保存的 Char 字段？
在字段定义中写 compute='_compute_my_field' 并加上 store=True，同时在计算方法上用 @api.depends(...) 指明触发字段。store=True 会把计算结果写进数据库，便于搜索和导出。
总结
Char 字段看似简单，但它们在日常 Odoo 使用中无处不在。理解它们的属性、数据库表现以及与其他字段类型的区别，会显著提升数据模型的健壮性与后续维护效率。
不论是通过 Odoo Studio 添加客户引用、在自定义 Python 模块中定义字段，还是通过 API 自动创建字段，遵循本文的模式都能帮助你一次性把事情做对，减少后续返工。
一个合理设计的数据模型与正确的字段类型选择，是成功 Odoo 实施的重要基础。Char 字段虽小，但用得好能避免很多日常痛点。
我们（Dasolo）为企业提供 Odoo 实施、定制与优化服务。如果你需要梳理数据模型、添加或规范字段，或从头开发模块，我们可以提供支持。 欢迎联系我们 让我们开始讨论你的 Odoo 项目吧。