WSL2安装PostgreSql并远程连接Windows图形工具

“个性化需求/小白缝合低创”

Ubuntu 版本为 24.04.3
Windows 图形工具在本文中具体指 VScode

WSL2 的安装教程网络上较为详细，不多说了

1. 使用 WSL2 安装 PostgreSql

1. 更新系统包

sudo apt update && sudo apt upgrade -y

两条命令的意思如下， -y 表示如果有提问全部 yes

命令	描述
`sudo apt update`	更新软件包列表，检查可用的软件包更新
`sudo apt upgrade`	安装可用的软件包更新

2. 安装 PostgreSQL 及常用扩展

sudo apt install -y postgresql postgresql-contrib

sudo apt install 是安装命令

3. 启动数据库服务

sudo service postgresql start

4.检查运行状态

sudo service postgresql status

看见绿色的 active 就说明正常启动了

5.进入默认 postgres 用户 Shell

sudo -u postgres psql

出现提示符 postgres=# 表示已进入数据库命令行可以执行操作，想退出便输入 \q 或按 Ctrl+D。

2. 准备连接

使用 “本机回环地址” 127.0.0.1 进行本地连接。

1. PostgreSql 准备

我们先创建一个测试用户和相应的测试数据库。

在数据库命令行（如果退出，重新进一下），依次输入以下 SQL 命令：

CREATE USER test WITH PASSWORD 'test123';

创建 test 账户，密码是 test123；

CREATE DATABASE testdb OWNER test;

在 test 账户下创建 testdb 数据库；

没有报错说明执行成功。

2. VScode 准备

进入扩展 -> 直接搜索 PostgreSQL -> 找到官方发布的扩展

点击安装 -> 安装完毕

点击侧栏 大象头 -> 服务器新建连接
如图：把之前设的用户密码啥的填进去

然后点击高级 -> 端口填 5432 -> 点击服务器把 主机 IP 地址 填成 127.0.0.1

最后，点击测试联机 -> 成功 -> 点击保存并连接 -> 绿点成功

3. 连接完成，测试可用

我们在 VScode 这边建立一个查询然后使用 WSL 的 PostgreSQL命令行查看对照，看看可不可用。

1. VScode 建表

testdb 右键，点击新建查询

我们输入一个建表的 SQL 命令
命令如下：

CREATE TABLE test_table (
    id SERIAL PRIMARY KEY,
    data TEXT
);

点击绿色小三角运行 -> 查询历史记录 处绿勾说明成功

1. PostgreSQL 命令行查表验证

WSL 处输入：

psql -h 127.0.0.1 -U test -d testdb -W

片段	含义
`psql`	启动 PostgreSQL 交互式终端
`-h 127.0.0.1`	指定要连接的 IP 地址
`-U test`	指定登录的账户
`-d testdb`	指定数据库
`-W`	强制提示密码