You need to enable JavaScript to run this app. VS Code运行C/C++代码时出现arm64架构Undefined symbols错误如何解决
优惠活动
大模型
产品
解决方案
定价
更多

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。
    修正方法:
    1. 执行ls /opt/homebrew/bin/gcc*查看你安装的gcc版本,比如gcc-13、g++-13
    2. 打开VS Code C/C扩展设置,将「编译器路径」设置为上面查到的g路径,比如/opt/homebrew/bin/g++-13
    3. 临时测试可以直接在终端执行命令:/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

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.18 06:24:01