双击自定义扩展名文件时WinMain()无法接收足够参数

问题概述 #

之前双击自定义扩展名文件，通过右键「打开方式」指定自研C++ EXE程序打开时，程序可正常接收两个参数：自身路径与被点击文件路径。但当前无论Debug还是Release编译版本，仅能获取到1个参数（仅程序自身路径）。使用Windows 10系统与Visual Studio开发，怀疑是近期Windows更新导致该问题。

重现代码 #

int WINAPI WinMain(HINSTANCE hInstance, HINSTANCE hPrevInstance, LPSTR lpCmdLine, int nCmdShow){

    int nArgs;
    LPWSTR *szArglist = CommandLineToArgvW(GetCommandLine(), &nArgs);  // GetCommandLine() 定义在 processenv.h 中
    
    // nArgs 对应 argc，szArglist 对应 argv
    // 第一个参数为程序路径，第二个为被点击文件路径

    if(nArgs <= 1){  
        LocalFree(szArglist);  
        return EXIT_FAILURE;  
    } // 参数不足（1个或更少）

    LocalFree(szArglist);
    return EXIT_SUCCESS;
}

排查与解决方法 #

1. 检查文件关联注册表配置 #

Windows文件关联的注册表项如果配置错误，会直接导致参数无法传递：

• 按Win+R输入regedit打开注册表编辑器
• 定位到自定义扩展名对应的项（如HKEY_CLASSES_ROOT\.xxx），查看默认值对应的关联程序标识（例如MyApp.File）
• 进入HKEY_CLASSES_ROOT\[关联程序标识]\shell\open\command，检查默认值格式：
  正确格式应为："C:\完整路径\你的程序.exe" "%1"
  • 必须用引号包裹程序路径（若路径含空格）
  • %1是传递被点击文件路径的占位符，缺失则程序收不到参数

2. 验证程序命令行解析逻辑 #

• 字符集设置：在Visual Studio中，右键项目→属性→配置属性→常规，将“字符集”设为「使用Unicode字符集」，避免编码转换导致参数丢失
• 手动传参测试：打开命令提示符，手动运行程序并传入文件路径，例如：

  "C:\你的程序路径\App.exe" "C:\测试文件\test.xxx"
  

  若此时nArgs为2，说明程序逻辑正常，问题出在文件关联配置；若仍为1，则需排查程序的命令行解析代码

3. 重新创建文件关联 #

若注册表配置无误但问题依旧，可能是Windows更新重置了关联规则，可重新关联：

• 右键自定义扩展名文件→打开方式→选择其他应用→勾选「始终使用此应用打开.xxx文件」，重新选择你的EXE程序
• 或用命令行注册：

  assoc .xxx=MyApp.File
  ftype MyApp.File="C:\你的程序路径\App.exe" "%1"
  

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