如何安装使用纯开源dbt？本地dbt Core安装与免费学习指南

完全无需购买dbt云服务/企业版，本地部署开源dbt Core即可对接PostgreSQL、DuckDB搭建全开源数仓栈，全程仅需修改配置文件、填写数据库连接串，无复杂云平台配置流程。

一、纯开源dbt Core安装步骤 #

前置依赖：本地安装Python 3.8及以上版本即可，无需额外安装云平台客户端。

• 创建独立Python虚拟环境，避免依赖冲突，终端执行：
  python -m venv dbt-env
  激活虚拟环境：
  macOS/Linux系统执行source dbt-env/bin/activate，Windows系统执行dbt-env\Scripts\activate.bat
• 按需安装对应数据库的开源适配包，无需安装全量冗余组件：
  对接DuckDB执行pip install dbt-duckdb
  对接PostgreSQL执行pip install dbt-postgres
  验证安装：终端执行dbt --version，正常输出版本信息即安装成功，全程无付费环节、无强制云账号注册要求。

二、本地数据库对接配置（无云服务依赖） #

所有配置仅需修改项目根目录下的profiles.yml文件，无需登录任何云平台、无需填写授权信息。

• DuckDB对接配置示例：

your_project_name:
  target: dev
  outputs:
    dev:
      type: duckdb
      path: './local_dwh.duckdb' # 本地数仓文件存储路径，可自定义
      schema: dbt_dev

• PostgreSQL对接配置示例，直接填写本地/自建PG连接信息即可：

your_project_name:
  target: dev
  outputs:
    dev:
      type: postgres
      host: localhost # 自建PG地址，远程部署替换为对应IP即可
      user: 你的PG用户名
      password: 你的PG密码
      port: 5432
      dbname: 目标PG库名
      schema: dbt_dev
      threads: 4

配置校验：进入项目目录执行dbt debug，所有校验项返回pass即对接成功，全程无需绑定支付信息。

三、零付费系统学习dbt路径 #

无需开通云服务试用、无需购买付费课程，本地环境即可覆盖所有dbt核心功能的学习：

• 入门阶段：执行dbt init初始化本地项目，选择已安装的DuckDB/PostgreSQL适配器，结合项目自动生成的示例文件，掌握model、source、test、macro等核心概念，本地执行dbt run、dbt test即可直接查看运行结果，无需依赖云平台可视化界面。
• 进阶阶段：跳过官方文档中所有带「Cloud」「Enterprise」标识的云专属内容，仅学习标注适用于dbt Core的功能说明，在本地环境逐一复现增量模型、快照、包管理、文档生成等功能：本地执行dbt docs generate+dbt docs serve即可在本地浏览器打开自动生成的数仓文档，和云版文档功能完全一致，无核心功能阉割。
• 实战阶段：将公开CSV数据集导入本地DuckDB/PostgreSQL，从ODS到DWS层搭建完整数仓分层模型，跑通全流程转换逻辑，即可覆盖90%以上日常dbt使用场景。
  避坑提示：dbt Core和云版的核心ELT转换能力完全一致，云版额外提供的多人协作、托管调度、企业级权限等功能，个人学习者和小团队基本无使用需求，无需为此付费。

内容的提问来源于stack exchange，提问作者Hebron Watson