NASM编译报错：undefined reference to `print_string`等问题求助

一、当前错误的修复步骤 #

1. 解决undefined reference to print_string/read_int等函数错误 #

• 确认asm_io.obj的生成格式：MinGW使用COFF格式的目标文件，生成asm_io.obj时必须指定格式，执行命令：

  nasm -f win32 asm_io.asm -o asm_io.obj
  

  注：即使是64位系统，编译该书的32位示例程序也必须加-f win32，否则格式不匹配会导致链接失败。
• 链接时包含asm_io.obj：编译主程序（比如sum.asm）生成目标文件后，链接命令必须同时包含主程序.obj和asm_io.obj，并指定32位模式：

  nasm -f win32 sum.asm -o sum.obj
  gcc -m32 sum.obj asm_io.obj -o sum.exe
  

  -m32参数告诉gcc链接32位程序，避免因位数不匹配导致的符号找不到问题。
• 检查主程序的引用与调用：确保主程序开头正确包含头文件：

  %include "asm_io.inc"
  

  调用函数时遵循cdecl调用约定（该书的asm_io库使用此约定），直接用call print_string即可，无需额外栈操作。

2. 解决undefined reference to WinMain@16错误 #

这个错误是因为链接器找不到控制台程序的入口点，需做以下调整：

• 在主程序开头声明全局入口标签_main：

  global _main
  

• 将程序入口设置为_main:标签，而非start或其他自定义标签：

  _main:
      ; 你的程序逻辑代码
      call read_int
      ; ...其他操作
      mov eax, 0       ; 返回0表示程序正常结束
      ret
  

  gcc链接控制台程序时默认寻找_main作为入口，而非窗口程序的WinMain，这样就能解决该错误。

二、该书学习的环境配置建议 #

1. 工具选型与安装 #

• MinGW-w64：选择带32位支持的版本（比如i686-posix-dwarf），确保能编译链接32位程序。
• NASM：安装对应系统版本的NASM，添加到系统环境变量，方便终端直接调用。
• VS Code插件：安装NASM x86 Syntax提供汇编语法高亮，Code Runner可快速运行程序（需配置正确命令）。

2. 项目目录规范 #

将asm_io.asm、asm_io.inc与你的汇编代码放在同一项目目录下，避免编译链接时路径找不到的问题。

3. VS Code一键编译配置 #

通过配置tasks.json实现一键编译链接，示例配置如下（放在.vscode目录下）：

{
    "version": "2.0.0",
    "tasks": [
        {
            "label": "Compile asm_io",
            "command": "nasm -f win32 asm_io.asm -o asm_io.obj",
            "type": "shell",
            "problemMatcher": "$nasm"
        },
        {
            "label": "Compile Main",
            "command": "nasm -f win32 ${file} -o ${fileBasenameNoExtension}.obj",
            "type": "shell",
            "problemMatcher": "$nasm"
        },
        {
            "label": "Link",
            "command": "gcc -m32 ${fileBasenameNoExtension}.obj asm_io.obj -o ${fileBasenameNoExtension}.exe",
            "type": "shell",
            "problemMatcher": "$gcc"
        },
        {
            "label": "Build All",
            "dependsOn": ["Compile asm_io", "Compile Main", "Link"],
            "group": {
                "kind": "build",
                "isDefault": true
            }
        }
    ]
}

配置完成后，按Ctrl+Shift+B即可一键编译链接整个项目。

4. 调试配置（可选） #

如果需要调试汇编代码，配置launch.json使用gdb调试32位程序：

{
    "version": "0.2.0",
    "configurations": [
        {
            "name": "Debug 32-bit ASM",
            "type": "cppdbg",
            "request": "launch",
            "program": "${workspaceFolder}/${fileBasenameNoExtension}.exe",
            "args": [],
            "stopAtEntry": true,
            "cwd": "${workspaceFolder}",
            "environment": [],
            "externalConsole": true,
            "MIMode": "gdb",
            "miDebuggerPath": "gdb.exe",
            "setupCommands": [
                {
                    "description": "Enable pretty-printing for gdb",
                    "text": "-enable-pretty-printing",
                    "ignoreFailures": true
                }
            ],
            "preLaunchTask": "Build All"
        }
    ]
}

内容的提问来源于stack exchange，提问作者Jack G