LNK2001: unresolved external symbol __imp___std_init_once_begin_initialize 问题解决

LNK2001: unresolved external symbol __imp___std_init_once_begin_initialize 解决

问题背景

---

Visual Studio 2019 对 CMakeLists.txt 的支持不是很好，使用 “文件 (File)” → “打开 (Open)” → “CMake…” 方式打开工程代码

链接同样使用 Visual Studio 2019 生成的静态库时出现了这个问题

LNK2001: unresolved external symbol __imp___std_init_once_begin_initialize
LNK2001: unresolved external symbol __imp___std_init_once_complete
1
2

一般出现 unresolved external symbol （无法解析的外部符号）表示编译器没有找到函数的实现，也就是函数体。

方法一：使用预编译指令

---

在 Visual Studio 开发者社区看到一个帖子是这样说的

Some functions in msvcprt.lib have been renamed at some point, and the linker is supposed to do the necessary redirection automatically for you. However, I assume that the redirection is not correctly seen by the linker anymore and thus not applied. You can add the necessary code anywhere in your own though.

在 msvcprt.lib 库中的一些函数在某次迭代更新后被重命名，链接器应该会自动执行必要的重定向。但是，实际情况是链接器并未找到正确的指令，因此未进行正确的重定向。不过，你可以在自己的代码中合适的位置添加如下必要的代码。

#if _MSC_VER >= 1932
#pragma comment(linker, "/alternatename:__imp___std_init_once_complete=__imp_InitOnceComplete")
#pragma comment(linker, "/alternatename:__imp___std_init_once_begin_initialize=__imp_InitOnceBeginInitialize")
#endif
1
2
3
4

注：关于 _MSC_VER 的版本对应问题见文章附录

我们使用 Visual Studio 的开发人员命令提示工具查看 msvcprt.lib 库的预处理指令 （dumpbin /directives）

dumpbin /directives “C：\Program FilesMicrosoft Visual Studio\2022\Enterprise\VC\Tools\MSVC14.32.31326\libx64\msvcprt.lib”
1

能看到 类似如下内容

-----------------
/ALTERNATENAME:__imp___std_init_once_begin_initialize=__imp_InitOnceBeginInitialize
/ALTERNATENAME:__imp___std_init_once_complete=__imp_InitOnceComplete
1
2
3

这是应该自动转发到链接器的内容，出于某种原因未成功。目前这种方法是处理 Visual Studio 2022 初期版本的问题，后续的版本应该是修复了。

方法二：使用相同的环境

---

本人这里遇到的问题，原因是：两个 Visual Studio 的版本不一致，也就是编译静态库的开发环境和使用静态库的开发环境不一致，虽然都是 2019，但一个是 16.0.0 另一个是较新的版本，额外还安装了 Visual Studio 2022

然后使用同一版本的 Visual Studio 2019，就不再有此种链接问题。

参考链接

---

https://developercommunity.visualstudio.com/t/-imp-std-init-once-complete-unresolved-external-sy/1684365

https://learn.microsoft.com/en-us/cpp/preprocessor/predefined-macros

附录

---

Visual Studio 版本与 _MSC_VER 对应表