在 Swift 中，#if DEBUG 是一种编译条件，允许编写仅在调试（Debug）配置下运行的代码。这种机制非常适合在开发过程中添加一些调试代码，但又不希望这些代码在发布到生产环境的应用中存在。
基本语法
#if DEBUG
// 调试环境下执行的代码
#else
// 发布环境下执行的代码（可选）
#endif常见使用场景
1、示例数据
当需要为 SwiftUI 视图或测试环境提供示例数据时，可以用 #if DEBUG 来确保这些数据仅在调试环境中生效：
struct Location {
let id: UUID
let name: String
let description: String
#if DEBUG
static let example = Location(id: UUID(), name: "Example Place", description: "This is a sample location for debugging.")
#endif
}
在这里，example 属性仅会在调试模式下编译，避免在生产代码中引入无用的测试数据。
2、调试日志
通过 #if DEBUG，可以编写仅在调试模式下打印日志的代码，而不会污染发布版的输出：
func debugPrint(_ message: String) {
#if DEBUG
print("[DEBUG] \(message)")
#endif
}3、条件性调试逻辑
可以在调试模式下使用一些专门的功能，比如模拟环境、显示调试 UI 等：
var body: some View {
VStack {
Text("Hello, world!")
#if DEBUG
Text("Debug mode is enabled.")
.foregroundColor(.red)
#endif
}
}在发布模式下，Text(“Debug mode is enabled.”) 不会被编译到应用中。
4、自定义调试工具
如果需要在调试环境中添加临时功能，比如快速导航到某个页面或启用开发工具，可以利用 #if DEBUG：
struct DebugMenu: View {
var body: some View {
#if DEBUG
NavigationView {
List {
NavigationLink("Test Screen 1", destination: TestScreen1())
NavigationLink("Test Screen 2", destination: TestScreen2())
}
.navigationTitle("Debug Menu")
}
#else
EmptyView()
#endif
}
}与环境配置结合
如果在项目中没有启用 -D DEBUG 标志，#if DEBUG 条件语句将不会生效，编译器会将其视为 false，并跳过所有在 #if DEBUG 块中的代码。这意味着调试模式代码将不会运行。
具体含义
-D DEBUG 是 Swift 编译器的一个自定义标志，表示当前代码是针对调试环境进行编译的。
#if DEBUG 依赖这个标志来判断条件是否为真。
如果 -D DEBUG 存在，#if DEBUG 为真，编译器会包含该代码块。
如果 -D DEBUG 不存在，#if DEBUG 为假，代码块被忽略。
默认情况下
Xcode 默认在创建项目时为 Debug 配置启用了 -D DEBUG 标志，所以不需要手动添加。
可以通过以下步骤确认：
1、打开 Xcode，进入项目的设置页面。
2、点击左侧项目导航中的 Project 或 Target。
3、进入顶部的 Build Settings 选项卡。
4、在右上角的搜索框中，搜索 Swift Compiler。
5、找到 Active Compilation Conditions（旧版叫 Swift Compiler – Custom Flags）。
Active Compilation Conditions
此处可以定义 Swift 编译的条件标志，例如 DEBUG。
Debug 配置中默认会添加 DEBUG 标志。
Release 配置中通常不会有 DEBUG，避免调试代码进入生产环境。
如何确认 DEBUG 已生效？
确认 Debug 配置 中是否包含 DEBUG。
验证代码：
#if DEBUG
print("Debug Mode")
#else
print("Release Mode")
#endifDebug 模式输出：Debug Mode
Release 模式输出：Release Mode
Debug（调试）模式下截图：
Release（发布）模式下截图：
注意事项
1、生产代码中避免残留的调试逻辑：
使用 #if DEBUG 确保调试代码不会误导用户或泄露敏感信息。
2、优化发布性能：
调试模式下可能会有额外的开销，比如日志输出、调试 UI 等。用 #if DEBUG 隔离这些逻辑，发布版可以更高效。
3、安全性：
确保调试代码不会暴露内部实现或安全机制（例如：调试账户或密钥）。
总结
#if DEBUG 是一个非常有用的工具，可以帮助编写更高效、更清晰的调试代码，同时确保这些代码不会污染发布版本。合理使用可以显著提升开发和调试的效率！
扩展知识
切换调试和发布模式
在确认DEBUG生效时，需要通过切换调试或发布模式来验证，切换方式为：
1、点击顶部的项目名称：
2、点击“Edit Scheme… ”：
3、找到“Run”-“Info”-“Build Configuration”，选择“Debug（调试）”或“Release（发布）”后，点击“Close”按钮，完成模式的切换。
