Power Apps 命名约定——我希望从第一天起就使用的

Source: Dev.to

介绍

当我第一次开始构建 Power Apps 时，我并不认为命名约定重要。所有东西都能正常工作……直到我的应用变大，公式变得难以阅读。几个简单的命名习惯彻底改变了我的应用维护难度。

为什么命名约定很重要

• 可读性 – 清晰的名称让公式一眼就能看懂。
• 调试 – 更容易定位问题根源。
• 维护 – 当你知道每个元素的作用时，后续更改会更快。
• 协作 – 团队成员可以在没有陡峭学习曲线的情况下加入工作。

Microsoft 的 Power Apps 编码指南建议对屏幕、控件、变量和集合使用一致的命名，因为这可以提升可读性和可维护性。

通用命名模式

prefix_Purpose

• prefix – 表示控件类型（按钮、标签、文本输入等）。
• Purpose – 描述该控件的功能。

示例

• btn_SubmitForm
• txt_UserEmail
• lbl_StatusMessage

控件前缀

目标： prefix = 控件类型 + name = 它的功能。
当你看到 btn_SubmitRequest 时，立刻就知道它是一个提交请求的按钮。

屏幕命名

描述性的屏幕名称可以提升开发者体验和可访问性。

好的示例

• HomeScreen
• EmployeeRequestScreen
• ApprovalScreen

不好的示例

• Screen1
• Dashboard
• Page2

变量命名

变量应当指示它们存储的内容以及作用域。

集合命名

集合通常以 col_ 开头，并描述其内容。

• colEmployees
• colNavigationMenu
• colActiveRequests

综合示例

不要使用像 Gallery1、Label4、Button2 这样的通用名称，而应使用描述性的前缀：

gal_Employees
lbl_EmployeeName
btn_SaveEmployee

这样公式就像真实的业务逻辑一样易读：

If(
    btn_SaveEmployee.Visible,
    /* your logic here */
)

更容易理解。

最重要的规则

并不存在唯一的“完美”命名体系。不同团队可能会采用略有差异的模式，但 一致性 才是关键。统一的命名结构让应用更易于导航、调试和长期维护。

快速检查清单

• 为每种控件类型使用明确的前缀。
• 描述每个控件、屏幕、变量和集合的用途。
• 在整个应用中保持命名约定的一致性。

你的未来的自己（以及你的团队成员）会感谢你的！