Lazarus 基础-预处理指令集-优快云博客

Lazarus是一种类Delphi的开发语言，其有着同Delphi基本一致的预处理指令集。由于其脱胎于C，且具有较好的跨平台GUI解决方案，所以在实际应用中具有很高的商业应用价值。

用途：多数编译型编程语言都支持预处理指令，它能让我们在跨平台，或特殊用途下根据预先定义的条件来编译全部或部分代码。比如项目处于开发中调试状态时，我们会向工程中添加一些特殊调试代码以发现BUG或监控运行状态，但在发布时又不想将这些代码包含其中，于是预处理指令可以帮上这个忙。又或者在跨平台开发中，我们需要根据发布的指定平台（比如windows或linux）来编译指令代码，这时使用预处理指令是非常有必要的，它能让我们在一个工程中分别编译出不同平台的应用程序来，而不需要每个平台编写一个工程。

指令格式：{$指令名称操作符}

定义位置：预处理指令通常定义在单元的头部，条件编译指令通常用于代码块中。

说明：同Pascal语法一样，预处理指令也是不区分大小写的；预处理指令是编译器FPC内置的，使用时无需引用任何单元。预处理指令也可以嵌套使用！

示例：

{$Ifdef Windows}

{$ifdef Delphi_16UP}

uses VCL.Stdcall;

{$Endif}

{$Else}

uses Stdcall;

{$Endif}

一、基本指令集

指令名称	操作符	指令用途	代码示例	说明
CodePage	ANSI UTF-7 UTF-8 UTF-16 Unicode ....	指定当前代码所使用的编码格式	{$CodePage UTF-8}	仅在Mode FPC模式下生效
Define	宏名称	自定义一个宏	{$Define Debug}	定义一个宏
Undef	宏名称	取消一个宏定义	{$Undef Debug}	取消宏定义
Ifdef	宏名称	判断某个宏是否被定义（是否存在宏）以决定是否执行代码	{$Ifdef Debug} A:=0; {$Else} A:=1; {$Endif}	配对使用，同Else/EndIF一起使用
else	--	IfDef/IfNDef的条件分支语句		必须同IfDef /Ifndef一起使用
Endif	--	结束一个if指令		必须同IfDef /Ifndef一起使用
IfNdef	宏名称	判断某个宏是否没有定义（是否不存在）	{$IfNDef Debug} A:=0; {$Else} A:=1; {$Endif}	与IfDef刚好相反
Include / i	文件名称	包含一个外部文件	{$Include File.inc}
if	表达式	判断表达式	{$if defined(FPC) or defined(TYPE)}
Macro	On/Off	宏指令开关

二、特殊预处理指令

指令名称	操作符	指令用途	代码示例	说明
Mode	Delphi FPC ObjFPC	指明FPC使用何种语法格式	{$Mode Delphi}使用Delphi语法 {$Mode ObjFpc}使用FreePascal语法	通常用于跨编译器保持代码兼容而设置
ModeSwitch	Out/In .....	模式切换
Inline	On/Off	内联指令
Warning	字符串	IDE相关	{$Warning your Message}	在编译时在IDE里显示一个警告信息，但编译会继续
Error/STOP	字符串	IDE相关	{$Error your error message}	在编译时在IDE里显示一个错误信息，编译会停止

备注：IDE相关的特殊处理指令仅仅是在使用IDE时有效，对程序的最终结果没有影响

三、系统自带的宏（部分，不断增加中...）

分类	宏名称	环境依赖	说明
操作系统平台	Windows MSWindows	Windows平台	判断当前操作系统是否为Windows
	Win32	32位Windows平台	判断当前操作系统是否为Win32平台
	Win64	64位Windows平台
	Linux	Linux平台
	MacOS	MacOS	苹果桌面系统
	Android	Android安卓
	AIX	Unix平台	IBM系统
	Amiga		一个早期的32位系统
	Unix	Unix平台
目标CPU平台	X86_64
	X86
	i386
	i8086
	ARM
	AArch64
	LoongArch64

Free Pascal Lazarus	Fpc_Version	FPC	定义了FPC的版本号，整型
Free Pascal Lazarus	LCLGTK LCLGTK2 LCLGTK3 LCLGTK4 LCLGTK5	GTK	判断当前设置是否使用了GTK库