VS Code运行C/C++代码时出现arm64架构Undefined symbols错误如何解决
arm64架构下
_main符号未找到报错解决方案 Undefined symbols for architecture arm64:
"_main", referenced from:
implicit entry/start for main executable
ld: symbol(s) not found for architecture arm64
clang: error: linker command failed with exit code 1 (use -v to see invocation)
报错核心原因
链接器生成可执行程序时,找不到C/C++程序必需的入口函数main对应的编译后符号_main,触发链接失败。
分步排查解决
检查文件后缀
你的代码使用了C标准头文件<cstdio>,必须将文件保存为.cpp后缀的C文件,若误存为.c后缀的C文件,编译器的符号解析规则不匹配会触发该报错。验证编译器调用是否正确
Mac系统默认的gcc命令是clang的别名,即使你通过Homebrew安装了官方gcc,VS Code默认也会优先调用系统自带的clang,极易出现架构匹配问题。
打开VS Code内置终端执行gcc -v,如果输出包含Apple clang字样,说明调用的不是你安装的Homebrew gcc。
修正方法:- 执行
ls /opt/homebrew/bin/gcc*查看你安装的gcc版本,比如gcc-13、g++-13 - 打开VS Code C/C扩展设置,将「编译器路径」设置为上面查到的g路径,比如
/opt/homebrew/bin/g++-13 - 临时测试可以直接在终端执行命令:
/opt/homebrew/bin/g++-13 你的文件名.cpp -o hello,编译成功后执行./hello即可看到输出。
- 执行
检查编译参数是否包含当前源文件
如果手动编译可以成功,但VS Code点击运行按钮报错,说明你的tasks.json任务配置错误,没有将当前编辑的源文件传入编译器,链接器自然找不到你写在该文件里的main函数。
打开.vscode/tasks.json文件,确认args数组中包含${file}参数,代表编译当前打开的源文件。确认架构匹配
Apple Silicon系列Mac需确保你安装的是arm64版本的Homebrew,若之前在Rosetta模式下安装了x86版本的Homebrew和gcc,会出现架构不匹配的报错。重新安装arm64版本的Homebrew和gcc即可解决。
内容的提问来源于stack exchange,提问作者A_01_Abhilash S Hathwar
相关产品推荐
相关产品推荐

