QT控件命名简写

在企业开发中，为提高代码可读性和团队协作效率，控件命名需遵循简洁性、一致性原则。基于您提供的Qt控件截图，以下是控件类型全称与推荐简写对照表，涵盖布局、容器、输入、显示四类控件：

---

一、布局控件（Layouts）

控件全称	推荐简写	示例
Vertical Layout	vlay	vlayMain
Horizontal Layout	hlay	hlayToolbar
Grid Layout	glay	glayForm
Form Layout	flay	flaySettings
Horizontal Spacer	hsp	hspLeft
Vertical Spacer	vsp	vspBottom

---

二、容器控件（Containers）

控件全称	推荐简写	示例
Group Box	gbx	gbxUserInfo
Scroll Area	sa	saContent
Tool Box	tbox	tboxTools
Tab Widget	tab	tabMain
Stacked Widget	sw	swPages
Frame	frm	frmBorder
Widget	wgt	wgtCustom
MDI Area	mdi	mdiWorkspace
Dock Widget	dw	dwSidebar
QAxWidget (ActiveX)	ax	axExcel

---

三、输入控件（Input Widgets）

控件全称	推荐简写	示例
Combo Box	cb	cbLanguage
Font Combo Box	fcb	fcbTitle
Line Edit	le	leUsername
Text Edit	te	teDescription
Plain Text Edit	pte	pteNotes
Spin Box	sb	sbQuantity
Double Spin Box	dsb	dsbPrice
Time Edit	te	teStartTime
Date Edit	de	deBirthday
Date/Time Edit	dte	dteCreated
Dial	dial	dialVolume
Horizontal Scroll Bar	hsb	hsbImage
Vertical Scroll Bar	vsb	vsbLog
Horizontal Slider	hsl	hslBrightness
Vertical Slider	vsl	vslOpacity
Key Sequence Edit	kse	kseShortcut

---

四、显示控件（Display Widgets）

控件全称	推荐简写	示例
Label	lbl	lblStatus
Text Browser	tb	tbHelp
Graphics View	gv	gvCanvas
Calendar Widget	cal	calSchedule
LCD Number	lcd	lcdTimer
Progress Bar	prog	progLoad
Horizontal Line	hline	hlineDivider
Vertical Line	vline	vlineSeparator
OpenGL Widget	gl	glRender
QQuickWidget (QtQuick)	qw	qwDashboard

---

五、按钮控件（Buttons）

控件全称	推荐简写	示例
Push Button	btn	btnSubmit
Tool Button	tbtn	tbtnSave
Radio Button	rbtn	rbtnOptionA
Check Box	chk	chkAgree
Command Link Button	clbtn	clbtnNext
Dialog Button Box	dbb	dbbConfirm

---

六、项视图控件（Item Views/Widgets）

控件全称	推荐简写	示例
List View	lv	lvFiles
Tree View	tv	tvDirectory
Table View	tblv	tblvData
List Widget	lw	lwItems
Tree Widget	tw	twHierarchy
Table Widget	tblw	tblwResults

---

七、命名规范总结

1. 前缀规则：

• • 控件类型简写 + 驼峰命名（如 btnSubmit、lblUserName）。

1. 避免歧义：

• • Text Edit → te（输入类） vs. Text Browser → tb（显示类）

1. 项目统一：

• • 团队提前约定简写表，禁止混用 btn/bt、cb/cmb。

1. 特殊保留：

• • QQuickWidget 简写 qw，区别于普通 Widget（wgt）。

---

代码示例对比

// 不推荐：无规范缩写 ✘
QPushButton *pushButton = new QPushButton("OK");// 推荐：统一缩写 ✔
QPushButton *btnOK = new QPushButton("OK");
QLineEdit *leUsername = new QLineEdit();
QGridLayout *glayForm = new QGridLayout();

⚠️ 注意：简写仅用于变量命名，UI文件（如XML）中仍建议保留全称以保证可读性。