objective-c在Xcode中编写第一个程序教程

打开 Xcode 后是不是一脸懵？满屏的按钮和选项不知道点哪个，新建项目时模板选了半天还是错，好不容易敲完代码运行却一堆红叉？不少零基础学 Objective-C 的朋友，第一次用 Xcode 都栽在这些问题上。其实啊，objective-c 在 Xcode 中编写第一个程序没那么难，就是步骤多了点，细节没注意到。今天兔子哥就手把手带大家做一遍，从打开 Xcode 到成功运行第一个程序，每个步骤都标上新手容易踩的坑，跟着做，半小时就能搞定，以后再写程序就有底气了。

一、打开 Xcode：别被界面吓住，找到 “新建项目” 入口

第一次打开 Xcode，界面可能有点复杂，但咱不用管那些高级功能，先找到新建项目的入口就行。
Xcode 启动后，会显示欢迎界面，上面有 “Create a new Xcode project” 的选项，点这个就能新建项目。如果不小心关掉了欢迎界面，也别慌，顶部菜单点 “File”→“New”→“Project”，效果一样。
有朋友问：“Xcode 界面这么多按钮，是不是得先学怎么用界面？” 其实不用。刚开始咱就用最基础的功能，等写出第一个程序，熟悉了基本操作，再慢慢研究其他功能。就像学开车，先学会启动和刹车，不用一开始就研究仪表盘上的每个按钮。

二、新建项目：选对模板是关键，别选错平台

新建项目时，选对模板直接决定后面能不能顺利运行，新手最容易在这里出错。

1. 选对平台和模板

在弹出的模板选择界面，左侧列表先选 “macOS”（别选 iOS，不然还得配置模拟器，新手容易懵），然后在右侧选 “Command Line Tool”—— 这是命令行工具模板，专门用来写简单程序，不用管界面，适合新手练手。

2. 填写项目信息

点 “Next” 后，要填几个信息：

• Product Name：项目名，随便起个简单的，比如 “FirstOCProgram”；
• Organization Identifier：组织标识，个人学习的话随便写，比如 “com.myfirst”；
• Language：一定要选 “Objective-C”，别选错成 Swift 了；
• 最后选个保存位置，建议新建个 “OC 练习” 文件夹专门放项目，好找。

避坑点：Language 别选错！之前有学员想写 Objective-C 程序，结果手滑选了 Swift，写的代码全报错，查了半天都没发现问题出在这。

三、认识项目结构：别被文件吓到，重点看这一个文件

项目建好后，Xcode 界面会显示一堆文件和文件夹，其实咱刚开始只需要关注一个文件 ——“main.m”。
在左侧项目导航栏里，找到 “FirstOCProgram” 文件夹，下面有个 “main.m” 文件，这就是咱们要写代码的地方。双击打开它，里面已经有几行默认代码：
objective-c

#import int main(int argc, const char * argv[]) {@autoreleasepool {// Insert code here...NSLog(@"Hello, World!");}return 0;}

这些代码是啥意思？简单说：

• #import ：导入基础框架，不然很多功能用不了；
• main 函数：程序的入口，代码从这里开始执行；
• @autoreleasepool：内存管理相关的，新手暂时不用懂，照着写就行；
• NSLog：打印内容到控制台，相当于 “输出” 功能。

不过话说回来，虽然这些默认代码能运行，但刚开始最好自己手动敲一遍，印象会更深，还能避免复制粘贴带来的隐形错误。

四、编写第一个程序：改改代码，让它更 “个性化”

默认的 “Hello, World!” 太普通，咱改改代码，让它打印自己的名字和年龄，更有成就感。
把 main.m 里的代码改成这样：
objective-c

#import int main(int argc, const char * argv[]) {@autoreleasepool {// 定义姓名和年龄变量NSString *name = @"小明";int age = 20;// 打印个人信息NSLog(@"大家好，我叫%@，今年%d岁！", name, age);NSLog(@"这是我用Objective-C写的第一个程序～");}return 0;}

代码解释：

• NSString *name = @"小明"：定义字符串变量 name，存名字（注意字符串要加 @）；
• int age = 20：定义整数变量 age，存年龄；
• NSLog 里的 %@和 % d 是占位符，分别对应字符串和整数，后面跟着要替换的变量。

避坑点：字符串必须加 @！如果写成 "小明" 没加 @，运行时会报错 “Expected expression”，这是新手最常犯的错。还有占位符要和变量类型对应，%@对应字符串，% d 对应整数，别弄混。

五、运行程序：点一下按钮，看结果

代码写完了，该运行看看效果了。Xcode 顶部工具栏有个三角形按钮（或者按 Command+R），这就是运行按钮，点它！
第一次运行可能会弹出 “Building FirstOCProgram” 的进度条，这是在编译代码，等它跑完。如果代码没错，底部控制台会显示：
plaintext

大家好，我叫小明，今年20岁！这是我用Objective-C写的第一个程序～

恭喜你！第一个 Objective-C 程序成功运行了！
如果运行时报错，别慌，看控制台的错误提示。比如提示 “Use of undeclared identifier 'name'”，说明变量 name 没定义，检查是不是漏写了定义语句；如果提示 “Format string is not a string literal”，可能是 NSLog 里的字符串没加 @。

六、避坑指南：新手常犯的 3 个错，我当初也中招过

1. 项目保存路径有中文或空格

如果保存项目时路径里有中文或空格，可能会导致编译失败，提示 “No such file or directory”。建议项目路径只用英文和数字，比如 “/Users/ 你的名字 / OC 练习 / FirstOCProgram”。

2. 忘记导入 Foundation 框架

如果没写 #import ，用 NSLog 或 NSString 时会报错 “Unknown type name 'NSString'”。记住，只要用到系统类，就得导入对应的框架。

3. 运行时选了错误的 “运行目标”

顶部工具栏有个显示 “FirstOCProgram> My Mac” 的下拉框，如果这里选错成其他设备，可能运行不了。确保选的是 “My Mac”，本地运行最稳妥。

七、小拓展：试试修改代码，探索更多功能

成功运行后，别停留在这一步，试试改改代码，比如：

• 把名字改成自己的，年龄改成实际年龄；
• 加一个变量存爱好，用 NSLog 打印出来；
• 试试计算 1+2 的结果，用 NSLog 输出。

有学员问：“Xcode 是怎么把代码变成能运行的程序的？” 这个问题我也问过老师，简单说就是编译过程，但具体编译器如何把 Objective-C 代码转换成机器能懂的指令，具体机制待进一步研究，新手暂时不用深究，先会用再说。
兔子哥觉得，写第一个程序的重点不是代码多复杂，而是熟悉整个流程 —— 从新建项目到运行成功，每个步骤都走通了，后面学更难的内容才不会慌。很多人觉得编程难，其实是被第一步吓住了，真动手做起来会发现，原来自己也能写出能运行的程序。
我当初写第一个 Objective-C 程序时，因为漏写了 @符号，卡了十几分钟，后来找到问题时特别有成就感。所以别害怕报错，每个错误都是学习的机会。现在你已经成功写出第一个程序了，这是个很棒的开始，接下来可以试试写更复杂的逻辑，比如计算、判断，慢慢积累，你会越来越熟练的！

标签： FirstOCProgram Organization