PostgreSQL下载与安装保姆级教程 (2024最新版) – wiki基地

作者： /

PostgreSQL下载与安装保姆级教程 (2024最新版)：从零到一，精通Postgres数据库环境搭建

前言：为什么选择 PostgreSQL？

在当今数据驱动的世界里，选择一个强大、可靠且功能丰富的数据库系统是项目成功的基石。PostgreSQL，通常简称为 “Postgres”，正是这样一位备受推崇的“全能型选手”。它是一款完全开源的对象关系型数据库系统（ORDBMS），以其卓越的稳定性、强大的功能集、高度的可扩展性和严格的SQL标准符合性而闻名于世。

与某些商业数据库相比，PostgreSQL不仅免费，还在许多高级功能上毫不逊色，例如对JSON/JSONB的原生支持、强大的事务控制、丰富的索引类型、地理空间数据处理（通过PostGIS扩展）等等。无论是初学者入门学习SQL，还是企业级应用处理复杂业务，PostgreSQL都能胜任。

本教程旨在为初学者提供一份“保姆级”的详尽指南，我们将手把手地带您走过在Windows操作系统上下载、安装、配置并验证PostgreSQL（以2024年最新的稳定版PostgreSQL 16为例）的全过程。即使您是第一次接触数据库，跟随本教程的步骤，也能轻松搭建起自己的第一个PostgreSQL开发环境。

第一部分：万事开头——准备工作

在正式开始安装之前，我们需要做好一些简单的准备工作，确保安装过程顺利无阻。

1. 确认系统环境

PostgreSQL对硬件的要求并不苛刻。对于学习和开发用途，一台主流配置的个人电脑完全足够。

  • 操作系统：本教程将以 Windows 10 / Windows 11 (64位) 为例进行演示。macOS和Linux用户可以参考官网文档，其安装过程通常通过包管理器（如Homebrew, APT, YUM）会更加便捷。
  • 磁盘空间：请确保安装盘（通常是C盘）至少有 1GB 的可用空间，这足以容纳PostgreSQL程序本身、附带工具以及初期创建的数据库。
  • 管理员权限：安装过程需要向系统目录写入文件并创建服务，因此请确保您拥有当前Windows用户的管理员权限。

2. 选择正确的PostgreSQL版本

访问PostgreSQL的官方网站是获取安装包最安全、最可靠的途径。

在官网首页，您通常能看到最新稳定版本的发布信息。截至2024年初，PostgreSQL 16 是最新的主版本。PostgreSQL的版本号通常格式为 主版本号.次版本号（例如 16.2）。对于新用户，我们强烈建议下载最新的稳定主版本，因为它包含了最新的功能优化和安全修复。本教程将使用 16.2 版本作为演示。

第二部分：步步为营——Windows系统下的下载与安装详解

这是本教程的核心部分。我们将详细拆解每一步操作，并解释每个选项的含义。

步骤一：下载安装包

  1. 打开浏览器，访问PostgreSQL官方网站 https://www.postgresql.org/。
  2. 在网站导航栏或首页醒目位置，点击 “Download” 按钮。
  3. 在下载页面，您会看到不同操作系统的图标。请点击 “Windows” 图标。

  4. 进入Windows下载页面后，您会看到一行醒目的文字：“Download the installer”。请点击这个链接。

    说明：这个链接会将您引导至 EDB (EnterpriseDB) 公司的网站。EDB是PostgreSQL社区的主要贡献者之一，他们打包的图形化安装程序是官方推荐的、对Windows用户最友好的安装方式。

  5. 在EDB的下载页面，您会看到一个列表，包含了不同版本的PostgreSQL安装包。请找到与您系统匹配的最新版本。

    • 选择版本：在下拉列表中选择最新的版本，例如 16.2。
    • 选择操作系统：选择 Windows x86-64。
    • 点击旁边的 “DOWNLOAD NOW” 按钮，浏览器将开始下载一个 .exe 格式的安装文件，文件名类似于 postgresql-16.2-1-windows-x64.exe。请耐心等待下载完成。

步骤二：启动安装程序

  1. 找到您刚刚下载的 .exe 文件（通常在“下载”文件夹中）。
  2. 关键一步：右键点击该文件，在弹出的菜单中选择 “以管理员身份运行”。这样做可以避免因权限不足导致的安装失败。
  3. 如果系统弹出用户账户控制（UAC）窗口，请点击 “是”。

步骤三：跟随安装向导完成安装（全程图文解说）

安装向导启动后，您将看到一系列配置窗口。请不要害怕，我们会逐一解释。

  1. Welcome (欢迎)

    • 这是欢迎界面，简单介绍了安装程序。直接点击 “Next” 继续。

  2. Installation Directory (安装目录)

    • 这里让您选择PostgreSQL的安装位置。
    • 默认路径通常是 C:\Program Files\PostgreSQL\16。
    • 建议：对于大多数用户，保持默认设置即可。除非您的C盘空间非常紧张，否则不建议修改。修改路径可能会影响后续环境变量的配置。
    • 确认后，点击 “Next”。

  3. Select Components (选择组件)

    • 这是非常重要的一步，决定了您要安装哪些工具。
    • PostgreSQL Server：这是数据库的核心服务，必须勾选。
    • pgAdmin 4：这是一个强大且用户友好的图形化管理工具，强烈推荐初学者必须勾选。您可以通过它来创建数据库、执行SQL查询、管理用户等，无需记忆复杂的命令。
    • Stack Builder：这是一个可选的工具，用于安装额外的驱动程序、扩展和工具（如PostGIS）。建议勾选，即使现在不用，以后也可能需要。
    • Command Line Tools：命令行工具（如 psql, pg_dump 等），对于开发者和高级用户来说是必须勾选的。
    • 总结：对于初学者，建议将这四个选项全部勾选。点击 “Next”。

  4. Data Directory (数据目录)

    • 这里让您选择数据库文件的存储位置。这些文件是您所有数据库的“家”。
    • 默认路径通常是 C:\Program Files\PostgreSQL\16\data。
    • 建议：同样地，保持默认设置即可。这个目录非常重要，未来的备份和恢复操作都与它相关。
    • 点击 “Next”。

  5. Password (为超级用户设置密码)

    • 极其重要的一步！ 安装程序会创建一个名为 postgres 的超级用户（类似于系统中的Administrator或root）。您需要为这个用户设置一个密码。
    • postgres 用户：拥有对整个PostgreSQL实例的最高权限。
    • 在 “Password” 和 “Retype password” 两个输入框中，输入一个您能牢记的密码。
    • 密码建议：请设置一个强密码（包含大小写字母、数字和符号），但务必、务必、务必牢牢记住它！忘记这个密码会给后续使用带来极大的麻烦。最好将它记录在安全的地方。
    • 设置好后，点击 “Next”。

  6. Port (端口号)

    • 这里设置PostgreSQL服务监听网络连接的端口号。
    • 默认端口是 5432。这是PostgreSQL的公认标准端口。
    • 建议：保持默认的5432即可。除非您的电脑上已经有其他程序占用了这个端口（非常罕见），否则不要修改。
    • 点击 “Next”。

  7. Advanced Options (高级选项 – 区域设置)

    • 这里让您选择数据库的区域设置（Locale），它会影响文本的排序规则、货币符号、日期格式等。
    • 建议：选择 “[Default locale]” (默认区域设置)。安装程序会自动使用您当前Windows系统的区域设置，这对于大多数中国用户来说（Chinese (Simplified)_China.936）是最佳选择，能正确处理中文字符。
    • 点击 “Next”。

  8. Pre Installation Summary (安装前摘要)

    • 这个界面会列出您之前所有的选择，供您最后一次检查。确认无误后，点击 “Next”。

  9. Ready to Install (准备安装)

    • 提示即将开始安装。点击 “Next”，安装过程正式开始。您会看到一个进度条，请耐心等待几分钟。

  10. Completing the PostgreSQL Setup Wizard (完成安装)

    • 当您看到这个界面时，恭喜您，PostgreSQL已经成功安装到您的电脑上了！
    • 界面上有一个复选框：“Launch Stack Builder at exit?” (退出时启动Stack Builder?)。
    • 建议：暂时取消勾选此项。我们可以在需要时再手动启动它，现在先让我们专注于验证核心安装是否成功。
    • 点击 “Finish”，完成安装。

第三部分：初试牛刀——安装后验证与基本使用

安装完成只是第一步，我们需要验证它是否正常工作，并学习如何连接到数据库。

方法一：使用图形化工具 pgAdmin 4

这是对初学者最友好的方式。

  1. 启动 pgAdmin 4：

    • 点击Windows的“开始”菜单，在程序列表中找到名为 “PostgreSQL 16” 的文件夹。
    • 点击展开，找到并点击 “pgAdmin 4”。

  2. 设置 pgAdmin 4 主密码：

    • 首次启动pgAdmin 4，它会要求您设置一个“主密码 (Master Password)”。
    • 请注意：这个密码是用来加密pgAdmin 4中保存的服务器连接信息的，它不是您之前为postgres用户设置的数据库密码。您可以设置一个新密码，也可以为了方便记忆，设置成与postgres用户密码相同。
    • 设置并确认密码后，点击“OK”。

  3. 连接到本地服务器：

    • 打开pgAdmin 4后，您会在左侧的“浏览器(Browser)”面板中看到一个“Servers”项。
    • 通常，安装程序会自动为您创建一个连接到本地服务器的配置，名为 “PostgreSQL 16”。
    • 点击“PostgreSQL 16”前面的小三角展开它，此时会弹出一个密码输入框。
    • 输入密码：在这里，请输入您在安装步骤三第5步中为 postgres 用户设置的那个数据库密码。您可以勾选“Save password?”以便下次自动登录。
    • 点击 “OK”。

  4. 验证成功与“Hello World”查询：

    • 如果密码正确，服务器连接会成功展开，您会看到 Databases, Login/Group Roles 等项。这标志着您已经成功连接到数据库了！
    • 让我们执行第一条SQL查询：
      • 右键点击 “PostgreSQL 16” 服务器，选择 “Query Tool…” (查询工具)。
      • 在右侧打开的查询编辑器中，输入以下SQL命令：
        sql
        SELECT version();
      • 点击工具栏上的“执行/刷新(Execute/Refresh)”按钮（一个闪电形状的图标），或者按 F5 键。
      • 在下方的“Data Output”面板中，您应该能看到类似 PostgreSQL 16.2, compiled by Visual C++ ... 的输出结果。
      • 再试一条：
        sql
        SELECT 'Hello, PostgreSQL! I am up and running!';
      • 执行后，您会看到这句问候语。

    恭喜！您已经通过pgAdmin 4成功与您的PostgreSQL数据库进行了交互。

方法二：使用命令行工具 SQL Shell (psql)

对于喜欢命令行的用户，psql 是一个强大而高效的工具。

  1. 启动 SQL Shell (psql)：

    • 同样地，点击Windows“开始”菜单 -> “PostgreSQL 16” 文件夹 -> 点击 “SQL Shell (psql)”。

  2. 连接数据库：

    • 一个黑色的命令行窗口会弹出，并依次提示您输入连接信息。对于本地连接，大部分可以直接按回车使用默认值。
    • Server [localhost]: 直接按 回车 (默认是本地主机)。
    • Database [postgres]: 直接按 回车 (默认连接到名为postgres的维护数据库)。
    • Port [5432]: 直接按 回车 (默认端口)。
    • Username [postgres]: 直接按 回车 (默认使用postgres超级用户)。
    • Password for user postgres: 在这里输入您在安装时设置的那个数据库密码。输入时屏幕上不会显示任何字符，这是正常的安全措施。输入完毕后按 回车。

  3. 验证成功与基本命令：

    • 如果密码正确，您将看到欢迎信息和 postgres=# 或 postgres=> 这样的提示符。这表示您已成功登录。
    • 在提示符后，输入同样的SQL查询，注意命令以分号;结尾：
      sql
      SELECT version();
      按回车，您会看到版本信息。
    • 尝试一些 psql 的元命令：
      • \l：列出所有的数据库 (list databases)。
      • \q：退出 psql (quit)。

第四部分：锦上添花——配置环境变量

为了能在任何命令行窗口（如CMD或PowerShell）中直接使用 psql, pg_dump 等命令，我们需要将PostgreSQL的bin目录和lib目录添加到系统的Path环境变量中。

  1. 找到路径：

    • bin 目录路径：C:\Program Files\PostgreSQL\16\bin
    • lib 目录路径：C:\Program Files\PostgreSQL\16\lib (某些工具可能需要)
    • (如果您的安装路径不同，请相应修改)

  2. 打开环境变量设置：

    • 在Windows搜索栏中输入 “环境变量”，然后选择 “编辑系统环境变量”。
    • 在弹出的“系统属性”窗口中，点击右下角的 “环境变量…” 按钮。

  3. 修改系统变量 Path：

    • 在下方的“系统变量”区域，找到名为 Path 的变量，选中它，然后点击 “编辑…”。
    • 在“编辑环境变量”窗口中，点击右上角的 “新建”。
    • 将 bin 目录的完整路径 C:\Program Files\PostgreSQL\16\bin 粘贴进去。
    • 再次点击 “新建”，将 lib 目录的完整路径 C:\Program Files\PostgreSQL\16\lib 粘贴进去。
    • 点击 “确定” 关闭所有打开的设置窗口。

  4. 验证配置：

    • 重要：打开一个新的 CMD 或 PowerShell 窗口（旧窗口不会加载新的环境变量）。
    • 输入以下命令并回车：
      sh
      psql --version
    • 如果屏幕输出了 psql (PostgreSQL) 16.2 这样的版本信息，说明环境变量配置成功！现在您可以在任何地方愉快地使用PostgreSQL的命令行工具了。

第五部分：后顾无忧——常见问题与卸载

常见问题 (FAQ)

  • 问：我忘记了 postgres 用户的密码怎么办？

    • 答：对于初学者，最简单粗暴的方法是：卸载PostgreSQL，手动删除Data数据目录，然后重新安装。对于生产环境有专门的密码重置方法，但过程较为复杂。所以，再次强调，请务必记好密码。

  • 问：安装时提示端口 5432 被占用怎么办？

    • 答：这说明您电脑上已有其他程序使用了此端口。您可以在安装时指定一个未被使用的端口，如 5433、5434。连接时，也需要指定这个新端口。

  • 问：安装失败了怎么办？

    • 答：请检查：是否以管理员身份运行的安装程序？是否关闭了所有杀毒软件和安全防护软件？查看安装日志（通常在用户的%TEMP%目录下）可能会有线索。

如何卸载 PostgreSQL

  1. 进入Windows的 “设置” -> “应用” -> “应用和功能”。
  2. 在应用列表中找到 “PostgreSQL 16”。
  3. 点击它，选择 “卸载”。
  4. 按照卸载向导的提示完成卸载。
  5. 注意：默认情况下，卸载程序可能会保留您的数据目录（Data Directory）。如果您想进行一次彻底的清理，请在卸载后，手动删除之前设置的安装目录（如 C:\Program Files\PostgreSQL\16）。

总结

至此，您已经完成了从下载、安装、配置到验证的全过程，成功在您的Windows电脑上搭建了一个功能完备的PostgreSQL数据库环境。您学会了使用 pgAdmin 4 和 psql 两种方式连接数据库，并执行了您的第一条SQL查询。

这仅仅是您探索PostgreSQL强大世界的开始。接下来，您可以开始系统地学习SQL语言，了解如何创建表、插入数据、进行复杂的查询；您也可以深入研究PostgreSQL特有的高级数据类型和功能。希望这篇保姆级的教程能为您打下坚实的基础，祝您在数据库的学习之路上行稳致远！

发表评论

您的邮箱地址不会被公开。 必填项已用 * 标注

滚动至顶部