# Windows下静态链接库

了解了什么是静态链接库之后，接下来就以 myMath.c 为例，教大家在 Windows 平台上创建一个静态链接库，并学会将他人分享的静态链接库引入到自己的项目中。

在 Windows 平台上创建静态链接库，我们选用的工具是 Visual Studio（简称 VS），它是微软发布的一款功能强大的 IDE（集成开发环境）。目前为止，VS 已经发布了多个版本，最新版本是 VS 2019，本节我们就以这个版本为例进行讲解，其它版本的操作方法也是类似的。

## 静态链接库的创建

首先，打开 VS2019，选择“创建新项目”：

![img](http://c.biancheng.net/uploads/allimg/210705/2-210F5140334548.gif)
图 1 创建新项目


弹出的对话框如图 2 所示，选择“静态库”：

![img](http://c.biancheng.net/uploads/allimg/210705/2-210F5140402G8.gif)
图 2 创建静态库项目


如图 3 所示，自定义所要创建的项目名和存储位置：



![img](http://c.biancheng.net/uploads/allimg/210705/2-210F5140424S5.gif)
图 3 自定义项目的名称和存储位置


初始状态下，创建好的静态库项目中会自动包含以下几个文件：



![img](http://c.biancheng.net/uploads/allimg/210705/2-210F51404435D.gif)
图 4 初始状态下的静态库项目


图 4 所示的这些文件，我们只保留 myMath.c 源文件（将 myMath.cpp 的后缀名改为 .c），其它三个文件直接删除即可。在此基础上，我们需要创建 myMath.c 对应的头文件，以便向他人分享静态链接库时展示具体的功能和用法。

例如，在项目中添加 myMath.h 作为 myMath.c 对应的头文件，鼠标右击图 4 的“头文件”，依次选择“添加 -> 新建项”，弹出的对话框中选择“头文件(.h)”并自定义文件名称即可。最终，项目中仅有 myMath.h 和 myMath.c 两个文件。

注意，由于我们没有使用 VS 默认提供的 pch.h 等文件，需要修改一下 VS 的设置。在图 4 所示的窗口中右击项目名（本节自定义的项目名称为 myMath），选择“属性”，会弹出图 5 所示的对话框：

![img](http://c.biancheng.net/uploads/allimg/210705/2-210F5140505G6.gif)
图 5 取消预编译头


完成以上操作后，就可以向 myMath.c 和 myMath.h 中添加代码了。以《[链接库是什么](http://c.biancheng.net/dll/what_is_library.html)》一节中的 myMath.c 为例，将 add()、sub()、mul()、div() 的函数声明部分添加到 myMath.h 文件中，将定义部分添加到 myMath.c 文件中。

```c
//myMath.h
//实现两个整数相加，返回它们的和
int add(int a, int b);
//实现两个整数相减，返回它们的差
int sub(int a, int b);
//实现两个整数相乘，返回它们的乘积
int mul(int a, int b);
//实现两个整数相除，返回它们的商
int div(int a, int b);
//myMath.c
#include "myMath.h"
int add(int a, int b) {
    return  a + b;
}
int sub(int a, int b) {
    return  a - b;
}
int mul(int a, int b) {
    return  a * b;
}
int div(int a, int b) {
    if (b != 0) {
        return a / b;
    }
    return -1;
}
```

菜单栏中依次选择“生成 -> 生成 myMath”（项目名称可能不同），或者直接按 Ctrl+B 组合键，VS 显示图 6 所示的信息就表示成功创建好了静态链接库。



![img](http://c.biancheng.net/uploads/allimg/210705/2-210F5140530X6.gif)
图 6 成功创建静态链接库的提示信息


图 6 中重点标注的路径，表明了新生成的静态链接库的存储位置。可以看到，Windows 平台静态链接库文件的后缀名为 .lib。

## 静态链接库的使用

项目中，无论是引用自己先前建好的静态链接库，还是他人分享的静态链接库，只需完成以下两个步骤（以建好的 myMath.lib 为例）：

\1) 假设我们想在 myDemo 项目中使用 myMath.lib 静态链接库，首先要引入 myMath.h 头文件，具体做法是：将 myMath.h 文件拷贝到 myDemo 项目中，鼠标右键点击图 7 中的 "myDemo" 项目名，选择“在文件资源管理器中打开文件夹”，即可找到 myDemo 项目的存储位置。

同时，将 myMath.h 文件引入到 myDemo 项目中：

![img](http://c.biancheng.net/uploads/allimg/210705/2-210F5140554350.gif)
图 7 项目中引入 .h 文件


选择“现有项”后会打开另一个对话框，找到 myMath.h 文件并将其引入到当前项目中。成功引入后，图 7 中的头文件下会显示 myMath.h 文件。

\2) 只引入 myMath.h 文件是远远不够的，.h 文件中各个函数的具体实现位于 myMath.lib 文件内，因此必须保证项目在链接阶段能成功找到 myMath.lib 文件。

一种较简单的方法是，用 #pragma 预处理指令指明要使用的静态链接库。假设 myMath.lib 的存储路径为 "D://myMath.lib"，则我们只需在 main.c 文件的开头加入以下代码：

```
#pragma comment (lib,"D://myMath.lib")
```

这行代码指明了 myMath.lib 静态链接库的存储位置，VS 就可以成功找到它。

例如，main.c 文件中的代码如下：

```
#include <stdio.h>
#include "myMath.h"
#pragma comment(lib,"D://myMath.lib")
int main()
{
    int a = 3, b = 5;
    printf("a+b=%d\n", add(3, 5));
    printf("a-b=%d\n", sub(3, 5));
    printf("a*b=%d\n", mul(3, 5));
    printf("a/b=%d", div(3, 5));
    return 0;
}
```

程序执行结果为：

a+b=8
a-b=-2
a*b=15
a/b=0
<!-- markdown for nginx, see https://phus.lu -->
<script>
!function(){
	var dom = {
		element: null,
		get: function (o) {
			var obj = Object.create(this)
			obj.element = (typeof o == "object") ? o : document.createElement(o)
			return obj
		},
		add: function (o) {
			var obj = dom.get(o)
			this.element.appendChild(obj.element)
			return obj
		},
		text: function (t) {
			this.element.appendChild(document.createTextNode(t))
			return this
		},
		attr: function (k, v) {
			this.element.setAttribute(k, v)
			return this
		}
	}

	if (!document.head) return
	head = dom.get(document.head)
	head.add('meta').attr('charset', 'utf-8')
	head.add('meta').attr('name', 'viewport').attr('content', 'width=device-width,initial-scale=1')

	if (!document.body) {
		document.write(["<div class=\"container\">",
		"<h3>nginx.conf</h3>",
		"<textarea rows=6 cols=50>",
		"# download markdown.html to /wwwroot",
		"location ~ \\.md$ {",
		"    default_type text/html;",
		"    add_after_body /markdown.html;",
		"}",
		"</textarea>",
		"</div>"].join("\n"))
		return
	}

	var bodytext = document.body.innerHTML
	document.body.innerHTML = ''

	div = dom.get('div').attr('class', 'container')

	div.add('script').attr('src', 'https://cdnjs.cloudflare.com/ajax/libs/marked/0.5.2/marked.min.js').attr('integrity', 'sha256-zFUosuESzULu5P+SZdjRRtBZR8+1u5RZDlbt3Q5KL8U=').attr('crossorigin', 'anonymous')
	div.add('link').attr('rel', 'stylesheet').attr('href', 'https://cdnjs.cloudflare.com/ajax/libs/github-markdown-css/5.1.0/github-markdown-light.min.css').attr('integrity', 'sha256-WQx0Y6LLZeGv3V3NVVge+YIL5MIOt45RPuFdkyNodls=').attr('crossorigin', 'anonymous')

	title = decodeURIComponent(document.location.pathname.replace(/.*\//, '').replace(/\.html$/, ''))
	document.title = '《' + title.replace(/\.md$/, '') + '》'
	tbody = div.add('table').add('tbody')
	tbody.add('tr').add('th').text(title).attr('class', 'octicon-book')
	tbody.add('tr').add('td').add('div').attr('id', 'readme').attr('class', 'markdown-body')

	wait = function (name, callback) {
		var interval = 10; // ms
		window.setTimeout(function() {
			if (window[name]) {
				callback(window[name])
			} else {
				window.setTimeout(arguments.callee, interval)
			}
		}, interval)
	}
	wait('marked', function() {
		document.getElementById("readme").innerHTML = marked.parse(bodytext)
	})

	document.body.appendChild(div.element)
}()
</script>

<style>
body {
	margin: 0;
	font-family: "ubuntu", "Tahoma", "Microsoft YaHei", Arial, Serif;
}
.markdown-body {
	float: left;
	font-family: "ubuntu", "Tahoma", "Microsoft YaHei", Arial, Serif;
}
.container {
	padding-right: 15px;
	padding-left: 15px;
	margin-right: auto;
	margin-left: auto;
}
@media (min-width: 768px) {
	.container {
		max-width: 80%;
	}
}
@media (min-width: 992px) {
	.container {
		max-width: 70%;
	}
}
@media (min-width: 1200px) {
	.container {
		max-width: 60%;
	}
}
table {
	width: 100%;
	max-width: 100%;
	margin-bottom: 20px;
	border: 1px solid #ddd;
	padding: 0;
	border-collapse: collapse;
}
table th {
	font-size: 14px;
}
table tr {
	border: 1px solid #ddd;
	padding: 5px;
}
table th, table td {
	border: 1px solid #ddd;
	font-size: 14px;
	line-height: 20px;
	padding: 3px;
	text-align: left;
}
.octicon-book {
	background-position: center left;
	background-repeat: no-repeat;
	padding-left: 20px;
	background-image: url("data:image/svg+xml;charset=utf8,%3Csvg xmlns='http://www.w3.org/2000/svg' width='16' height='16' viewBox='0 0 16 16'%3E%3Cpath d='M3,5 L7,5 L7,6 L3,6 L3,5 L3,5 Z M3,8 L7,8 L7,7 L3,7 L3,8 L3,8 Z M3,10 L7,10 L7,9 L3,9 L3,10 L3,10 Z M14,5 L10,5 L10,6 L14,6 L14,5 L14,5 Z M14,7 L10,7 L10,8 L14,8 L14,7 L14,7 Z M14,9 L10,9 L10,10 L14,10 L14,9 L14,9 Z M16,3 L16,12 C16,12.55 15.55,13 15,13 L9.5,13 L8.5,14 L7.5,13 L2,13 C1.45,13 1,12.55 1,12 L1,3 C1,2.45 1.45,2 2,2 L7.5,2 L8.5,3 L9.5,2 L15,2 C15.55,2 16,2.45 16,3 L16,3 Z M8,3.5 L7.5,3 L2,3 L2,12 L8,12 L8,3.5 L8,3.5 Z M15,3 L9.5,3 L9,3.5 L9,12 L15,12 L15,3 L15,3 Z' /%3E%3C/svg%3E");
}
</style>