16.1. 用Visual C++或Microsoft Windows SDK编译

PostgreSQL可以使用微软的Visual C++编译器套件来编译。这些编译器可以是Visual Studio, Visual Studio Express或者某些版本的Microsoft Windows SDK。如果没有安装Visual Studio的环境，最简单的方法是使用Windows SDK 7.1或者Visual Studio Express 2012 for Windows Desktop中的编译器, 它们都可以从微软官网免费下载。

PostgreSQL支持从Visual Studio 2005到Visual Studio 2012(包括精简版)的编译器, 以及6.0到7.1版本的独立的Windows SDK编译器。 64位的PostgreSQL只支持6.0a到7.1版本的Microsoft Windows SDK和Visual Studio 2008及其以上版本。

用Visual C++或Platform SDK编译的工具在src/tools/msvc目录下。编译时，确保系统路径下没有包含MinGW或Cygwin的工具，同时所需要的Visual C++工具在系统路径下是可用的。在Visual Studio中，启动Visual Studio Command Prompt。如果需要编译64位的版本，使用64位版本的命令，反之亦然。在Microsoft Windows SDK中，从开始菜单中SDK下的列表启动CMD shell。在最新版的SDK中，你可以使用setenv等命令来更改目标的CPU架构，编译类型和操作系统类型。指令setenv /x86 /release /xp用来编译Windows XP或更新的32位版本。使用/?命令可以查看setenv的其它用法。所有命令都应该在src\tools\msvc目录下运行。

在编译前，根据需要修改config.pl中相应选项和使用到的第三方库的路径。完整的配置由首先读取和解析的config_default.pl决定，然后从config.pl获取变更。例如，为了指定Python的安装路径，在config.pl文件中添加以下语句:

$config->{python} = 'c:\python26';

只需要指定和config_default.pl文件中有差别的参数。

如果需要指定其它的环境变量，创建一个buildenv.pl文件并写入所需要的命令。例如，为了在PATH中添加一个还不存在的bison变量，创建一个文件包含以下内容：

$ENV{PATH}=$ENV{PATH} . ';c:\some\where\bison\bin';

16.1.1. 要求

编译PostgreSQL还需要以下几个工具。使用config.pl文件来指定这些库的路径。

Microsoft Windows SDK

如果编译环境不兼容所支持的Microsoft Windows SDK版本，建议把SDK的版本升级到最新的版本(目前为7.1版本),下载地址为http://www.microsoft.com/downloads/。

在SDK中，必须要保证包含Windows Headers and Libraries这部分内容。如果安装的Windows SDK中已经包含了Visual C++ Compilers，就不再需要使用Visual Studio进行编译了。注意Windows SDK 8.0a之后的版本不再附有完整的命令行编译环境。

ActiveState Perl

ActiveState Perl用于编译生成脚本，而MinGW或Cygwin的Perl则不起作用。同样，它的路径也要添加到系统路径中。二进制文件下载地址为http://www.activestate.com (注意: 必须使用5.8或者更新的版本，免费的标准版既可）。

下面的工具在开始时是不需要的，但是对于完整的包的编译是必须的。使用config.pl文件来指定这些库的路径。

ActiveState TCL

用于编译PL/TCL(注意:要求8.4版本，免费的标准版既可）。

Bison and Flex

Bison and Flex用来从GIT进行编译，对于发行版文件的编译是不需要的。 Bison需要1.875或2.2及更新版本。Flex需要使用2.5.31或更新版本。

Bison and Flex包含在msys工具套件内。作为MinGW编译器套件的一部分，msys可以从http://www.mingw.org/wiki/MSYS下载。同时作为msysGit的一部分，msys也可以从http://git-scm.com/下载。

在buildenv.pl中，需要把包含flex.exe和bison.exe的目录添加到系统路径中，除非它们已经存在于系统路径中。对于MinGW, 要把MinGW安装目录的子目录路径\msys\1.0\bin添加到系统路径中。对于msysGit,要把Git安装目录下的bin目录添加到系统路径中。不要添加MinGW编译工具本身的目录到系统路径中。

Note: GnuWin32中的Bison存在一个bug，当文件安装的路径中含有空格的时候，会导致Bison出现故障。例如，用英文安装时的默认路径C:\Program Files\GnuWin32时会出现上述问题，解决办法是安装在类似C:\GnuWin32这样的目录，或者在GnuWin32的环境变量PATH中使用NTFS短名称路径(例如C:\PROGRA~1\GnuWin32)。

Note: 在PostgreSQL FTP上的winflex是旧的二进制版本，在64位Windows主机上执行时，会报"flex: fatal internal error, exec failed"的错误。可以使用msys中的flex来替代以避免这个问题。

Diff

Diff用于进行回归测试，可以从http://gnuwin32.sourceforge.net下载。

Gettext

Gettext用于编译NLS支持，可以从http://gnuwin32.sourceforge.net下载。需要注意的是二进制，依赖项和开发文件都需要。

MIT Kerberos

MIT Kerberos 用于提供Kerberos认证支持，可以从http://web.mit.edu/Kerberos/dist/index.html下载。

libxml2 and libxslt

libxml2和libxslt用于提供XML支持。可以从http://zlatkovic.com/pub/libxml下载二进制文件，也可以从http://xmlsoft.org下载源代码。需要注意，libxml2需要iconv，也在上面的地址下载。

openssl

openssl用于提供SSL支持。可以从http://www.slproweb.com/products/Win32OpenSSL.html下载二进制文件，或者在http://www.openssl.org下载源代码。

ossp-uuid

ossp-uuid用于提供UUID-OSSP支持(仅用于contrib)。可以从http://www.ossp.org/pkg/lib/uuid/下载。

Python

Python用于编译PL/Python。可以从http://www.python.org下载。

zlib

zlib用于为pg_dump和pg_restore提供压缩支持。可以从http://www.zlib.net下载二进制文件。

16.1.2. 针对64位Windows的注意事项

PostgreSQL的X64架构只能在64位Windows系统上编译，不支持安腾处理器。

同一个编译树上不支持32位和64位的混编。编译系统能自动检测平台环境是32位或64位，并编译出对应版本。因此，在编译前启动正确的命令行很重要。

在服务器端使用python或openssl这样的第三方库，必须是64位的。64位服务器上不支持对32位库的加载。一些第三方库只支持32位的PostgrSQL，这种情形下，它们不能用在64位的PostgreSQL上。

16.1.3. 编译

使用发行版配置(默认)来编译完整的PostgreSQL，运行命令：

<kbd class="literal">build</kbd>

使用调试配置来编译完整的PostgreSQL，运行命令：

<kbd class="literal">build DEBUG</kbd>

只编译单个项目，例如psql，运行命令：

<kbd class="literal">build psql</kbd>
<kbd class="literal">build DEBUG psql</kbd>

要将默认的编译配置改为调试配置，需要在buildenv.pl文件中加入下面的内容：

$ENV{CONFIG}="Debug";

也可以Visual Studio的图形化界面来编译，这时需要在命令行中运行：

<kbd class="literal">perl mkvcbuild.pl</kbd>

然后在Visual Studio中打开pgsql.sln文件(从资源树的根目录)。

16.1.4. 清除和安装

大多数时候，Visual Studio会自动追踪所依赖的文件的改动。但是当有大量改动的的时候，可能需要清除安装。要做到这一点，只需简单的运行clean.bat，它将自动的清除生成的相关文件。也可以在运行时添加dist参数，它的行为和<kbd class="literal">make distclean</kbd>命令比较相似，同时会清除flex/bison的输出文件。

默认情况下，所有的文件都会写在debug或release目录的一个子目录下面。要使用标准设置安装这些文件，初始化这些生成的文件并使用数据库，运行命令：

<kbd class="literal">install c:\destination\directory</kbd>

16.1.5. 运行回归测试

要运行回归测试，首先确保已经完成所需的编译。同时，确保用来加载系统所有部分(例如程序语言Perl和Python的DLLs)的DLLs已经在系统路径中存在。如果没有，通过buildenv.pl文件来设置。要运行测试，运行src\tools\msvc目录中的一个命令：

<kbd class="literal">vcregress check</kbd>
<kbd class="literal">vcregress installcheck</kbd>
<kbd class="literal">vcregress plcheck</kbd>
<kbd class="literal">vcregress contribcheck</kbd>

要改变调度方式(默认是并行),将它加在命令行后：

<kbd class="literal">vcregress check serial</kbd>

关于回归测试的更多内容，见Chapter 30。

16.1.6. 编译文档

把PostgreSQL文档编译成HTML格式的需要一些工具和文件。为所有这些文件创建一个根目录，将它们存储在下列的子目录中。

OpenJade 1.3.1-2

从 http://sourceforge.net/projects/openjade/files/openjade/1.3.1/openjade-1_3_1-2-bin.zip/download下载并解压到子目录openjade-1.3.1中。

DocBook DTD 4.2

从http://www.oasis-open.org/docbook/sgml/4.2/docbook-4.2.zip下载并解压到子目录docbook中。

DocBook DSSSL 1.79

从http://sourceforge.net/projects/docbook/files/docbook-dsssl/1.79/docbook-dsssl-1.79.zip/download下载并解压到子目录docbook-dsssl-1.79中。

ISO character entities

从http://www.oasis-open.org/cover/ISOEnts.zip下载并解压到子目录docbook中。

编辑buildenv.pl文件，为根目录的地址增加一个变量，如：

$ENV{DOCROOT}='c:\docbook';

要编译文档，运行builddoc.bat文件。注意为了生成索引，实际上编译运行来两次。生成的HTML文件存在于doc\src\sgml中。