完整的頭文件模板
#ifndef %FILENAME%_H
#define %FILENAME%_H/*** @brief The %CLASSNAME% class* @author %USER%* @date %DATE%*/
class %CLASSNAME% {
public:%CLASSNAME%();~%CLASSNAME%();// 禁止拷貝構造和賦值%CLASSNAME%(const %CLASSNAME%&) = delete;%CLASSNAME%& operator=(const %CLASSNAME%&) = delete;private:// Member variables
};#endif // %FILENAME%_H
模板說明:
-
頭文件保護宏:
#ifndef %FILENAME%_H
和#define %FILENAME%_H
防止頭文件被多次包含#endif // %FILENAME%_H
結束保護,注釋說明對應的宏名
-
類聲明:
- 默認構造函數和析構函數
- 使用
= delete
禁止拷貝構造和賦值操作(現代C++推薦做法)
-
文檔注釋:
- 使用Doxygen風格的注釋
- 包含作者和日期信息
-
占位符:
%FILENAME%
:將被替換為實際文件名(不帶擴展名)%CLASSNAME%
:將被替換為類名%USER%
:將被替換為系統用戶名%DATE%
:將被替換為當前日期
使用建議:
-
在Qt Creator中,可以將此模板保存為:
- 文件名:
class_template.h
- 路徑:
Qt安裝目錄/Tools/QtCreator/share/qtcreator/templates/wizards/classes/cpp/
- 文件名:
-
使用時:
- 右鍵項目 → 添加新文件 → C++ → C++ Class
- 系統會自動應用這個模板
-
對于現代C++項目,你還可以考慮添加:
- 移動構造函數和移動賦值運算符
- 默認使用
override
關鍵字(如果涉及繼承) - 使用
final
關鍵字(如果不希望被繼承)