0

0

C# 预处理指令#if, #else, #endif的用法 - 条件编译的实用技巧

畫卷琴夢

畫卷琴夢

发布时间:2025-12-05 09:01:02

|

815人浏览过

|

来源于php中文网

原创

条件编译指令#if、#else、#endif在C#中用于编译阶段控制代码包含,依据预定义符号如DEBUG、NET6_0或自定义符号决定;符号可通过项目属性、.csproj文件或命令行定义;支持逻辑组合与嵌套,常用于调试日志、多平台适配、功能开关和API兼容处理,提升代码灵活性与安全性。

c# 预处理指令#if, #else, #endif的用法 - 条件编译的实用技巧

#if、#else、#endif 是 C# 中用于条件编译的核心预处理指令,它们不改变运行时逻辑,而是在编译阶段决定哪些代码参与编译——这在多平台开发、调试控制、功能开关等场景中非常实用。

基本语法与工作原理

编译器根据预定义的符号(如 DEBUG、RELEASE 或自定义符号)是否被定义,来决定是否包含某段代码。未被选中的代码块不会被编译,也不会出现在最终程序集中,甚至不会进行语法检查(比如里面写了错别字也不会报错)。

常见写法:

  • #if DEBUG —— 当项目配置为 Debug 模式时生效(VS 默认已定义)
  • #if NET6_0 —— 针对 .NET 6.0 及以上版本启用特定代码(SDK 风格项目自动定义)
  • #if MY_FEATURE —— 自定义符号,需在项目文件或编译选项中手动添加

在项目中定义自定义符号

想用 #if MY_LOGGING?得先让编译器“认识”它:

X Detector
X Detector

最值得信赖的多语言 AI 内容检测器

下载
  • Visual Studio:右键项目 → 属性 → 生成 → 常规 → “条件编译符号”框里输入 MY_LOGGING(多个用分号隔开)
  • .csproj 文件中添加:DEBUG;TRACE;MY_LOGGING
  • 命令行编译(dotnet build):加参数 /p:DefineConstants="MY_LOGGING"

嵌套与组合判断

支持 #elif 和逻辑运算符,让条件更灵活:

  • #if DEBUG && !DISABLE_LOGGING —— 同时满足两个条件
  • #if WINDOWS || LINUX —— 满足任一即可(注意:这些符号通常由 SDK 自动定义)
  • 可嵌套:#if DEBUG#if UNIT_TEST → 内层代码只在 Debug + 单元测试环境下编译

典型实用场景

不是炫技,而是解决真实问题:

  • 调试专用日志:仅 Debug 下调用 Debug.WriteLine(),发布版完全剔除,零性能开销
  • 平台差异化实现:Windows 调用 Registry,Linux 读取配置文件,用 #if WINDOWS / #elif LINUX 隔离
  • 灰度功能开关:定义 FEATURE_PAY_V2,上线前编译两版程序,快速回滚
  • 规避不兼容 API:旧版 .NET 不支持 HttpClient.DefaultProxy,用 #if NET6_0_OR_GREATER 包裹

基本上就这些。用好条件编译,能让同一份代码适配更多环境,也避免把调试逻辑误带到生产中。

相关专题

更多
java基础知识汇总
java基础知识汇总

java基础知识有Java的历史和特点、Java的开发环境、Java的基本数据类型、变量和常量、运算符和表达式、控制语句、数组和字符串等等知识点。想要知道更多关于java基础知识的朋友,请阅读本专题下面的的有关文章,欢迎大家来php中文网学习。

1463

2023.10.24

Go语言中的运算符有哪些
Go语言中的运算符有哪些

Go语言中的运算符有:1、加法运算符;2、减法运算符;3、乘法运算符;4、除法运算符;5、取余运算符;6、比较运算符;7、位运算符;8、按位与运算符;9、按位或运算符;10、按位异或运算符等等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

228

2024.02.23

php三元运算符用法
php三元运算符用法

本专题整合了php三元运算符相关教程,阅读专题下面的文章了解更多详细内容。

85

2025.10.17

if什么意思
if什么意思

if的意思是“如果”的条件。它是一个用于引导条件语句的关键词,用于根据特定条件的真假情况来执行不同的代码块。本专题提供if什么意思的相关文章,供大家免费阅读。

737

2023.08.22

windows查看端口占用情况
windows查看端口占用情况

Windows端口可以认为是计算机与外界通讯交流的出入口。逻辑意义上的端口一般是指TCP/IP协议中的端口,端口号的范围从0到65535,比如用于浏览网页服务的80端口,用于FTP服务的21端口等等。怎么查看windows端口占用情况呢?php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

576

2023.07.26

查看端口占用情况windows
查看端口占用情况windows

端口占用是指与端口关联的软件占用端口而使得其他应用程序无法使用这些端口,端口占用问题是计算机系统编程领域的一个常见问题,端口占用的根本原因可能是操作系统的一些错误,服务器也可能会出现端口占用问题。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

1098

2023.07.27

windows照片无法显示
windows照片无法显示

当我们尝试打开一张图片时,可能会出现一个错误提示,提示说"Windows照片查看器无法显示此图片,因为计算机上的可用内存不足",本专题为大家提供windows照片无法显示相关的文章,帮助大家解决该问题。

790

2023.08.01

windows查看端口被占用的情况
windows查看端口被占用的情况

windows查看端口被占用的情况的方法:1、使用Windows自带的资源监视器;2、使用命令提示符查看端口信息;3、使用任务管理器查看占用端口的进程。本专题为大家提供windows查看端口被占用的情况的相关的文章、下载、课程内容,供大家免费下载体验。

452

2023.08.02

Java 桌面应用开发(JavaFX 实战)
Java 桌面应用开发(JavaFX 实战)

本专题系统讲解 Java 在桌面应用开发领域的实战应用,重点围绕 JavaFX 框架,涵盖界面布局、控件使用、事件处理、FXML、样式美化(CSS)、多线程与UI响应优化,以及桌面应用的打包与发布。通过完整示例项目,帮助学习者掌握 使用 Java 构建现代化、跨平台桌面应用程序的核心能力。

36

2026.01.14

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
C# 教程
C# 教程

共94课时 | 6.7万人学习

C 教程
C 教程

共75课时 | 4万人学习

C++教程
C++教程

共115课时 | 12.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号