本篇目标

完成 Xcode 下载与安装，配置 Command Line Tools，认识 Xcode 主界面五大区域，掌握常用快捷键。

一、下载与安装 Xcode

Xcode 是 Apple 官方提供的集成开发环境，包含代码编辑器、调试器、模拟器、界面设计工具等。

安装方式一：Mac App Store（推荐）

  1. 打开 Mac App Store

  2. 搜索 Xcode

  3. 点击下载并安装

  4. 安装完成后打开 Xcode，同意许可协议

  5. 等待组件安装完成

安装方式二：Apple 开发者网站

  1. 访问 developer.apple.com/download

  2. 登录 Apple ID

  3. 搜索 Xcode 版本

  4. 下载 .xip 文件

  5. 解压后拖入 Applications 文件夹

两种方式对比：

方式

优点

缺点

Mac App Store

自动更新，操作简单

下载速度受网络影响

开发者网站

可下载特定版本

需手动更新

二、安装后配置

首次启动：

  1. 打开 Xcode

  2. 同意许可协议

  3. 输入 Mac 密码，安装附加组件

  4. 等待组件安装完成

配置 Command Line Tools：

  1. 菜单栏 Xcode → Settings（或 Preferences）

  2. 选择 Locations 标签

  3. Command Line Tools 选择已安装的 Xcode 版本

  4. 关闭设置窗口

验证安装：

打开终端，输入：

xcodebuild -version

如果能输出版本号，说明安装成功。

检查模拟器：

  1. 菜单栏 Xcode → Open Developer Tool → Device Hub（旧版为 Simulator）

  2. 模拟器能正常启动，说明环境完整

三、Xcode 主界面概览

打开一个项目后，Xcode 主界面分为五个主要区域：

区域

位置

功能

导航区

左侧

浏览项目文件、符号、搜索、问题、调试

编辑区

中间

编写代码、编辑界面、查看文档

工具区

右侧

属性检查器、尺寸检查器、连接检查器

调试区

底部

控制台输出、变量查看、断点管理

工具栏

顶部

运行、停止、选择设备、项目状态

导航区常用标签：

  • Project Navigator（文件夹图标）：查看项目所有文件

  • Symbol Navigator（方块图标）：查看类、方法、属性

  • Find Navigator（放大镜）：全局搜索

  • Issue Navigator（感叹号）：查看编译错误和警告

  • Debug Navigator（虫子图标）：调试时查看线程和内存

  • Breakpoint Navigator（断点图标）：管理断点

工具栏常用按钮：

  • Run（三角形）：编译并运行

  • Stop（方形）：停止运行

  • Scheme：选择运行目标（模拟器或真机）

  • Editor Mode：切换编辑器布局（标准、助理、版本）

四、编辑区与代码编辑

编辑区是写代码的主要区域。Xcode 编辑器支持：

  • 语法高亮

  • 自动补全

  • 代码折叠

  • 快速跳转（Command + 点击）

  • 重构（右键 → Refactor）

  • 预览（SwiftUI 专属）

SwiftUI 预览：

在 SwiftUI 项目中，编辑区右侧可以打开预览窗口：

  1. 打开 ContentView.swift

  2. 点击右上角 Adjust Editor Options

  3. 选择 Canvas

  4. 或使用快捷键 Command + Option + Enter

预览窗口可以实时看到界面效果，修改代码后自动刷新。

五、常用快捷键

操作

快捷键

运行

Command + R

停止

Command + .

编译

Command + B

清理

Command + Shift + K

全局搜索

Command + Shift + F

打开快速导航

Command + Shift + O

显示/隐藏导航区

Command + 0

显示/隐藏工具区

Command + Option + 0

显示/隐藏调试区

Command + Shift + Y

打开预览

Command + Option + Enter

六、避坑指南

  • 下载速度慢：可尝试更换网络，或从开发者网站下载。

  • 磁盘空间不足：Xcode 安装后占用空间较大，建议预留 50GB 以上。

  • 版本不匹配：Xcode 版本需与 macOS 版本对应，不要盲目升级。

  • Command Line Tools 未配置：会导致部分命令行工具无法使用。

  • 首次启动慢：安装组件需要时间，耐心等待。

七、检查清单

  • [ ] Xcode 安装完成并能正常打开

  • [ ] Command Line Tools 已配置

  • [ ] 能通过终端输出版本号

  • [ ] 能说出 Xcode 五大区域的功能

  • [ ] 能使用快捷键运行和停止项目

  • [ ] 能打开 SwiftUI 预览