Terrastruct D2 图表工具安装指南全解析-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_00219/article/details/148362581

Terrastruct D2 图表工具安装指南全解析

d2 D2 is a modern diagram scripting language that turns text to diagrams. 项目地址: https://gitcode.com/gh_mirrors/d2/d2

前言

Terrastruct D2 是一款现代化的图表绘制工具，它采用声明式语法，让用户能够通过简单的文本描述快速生成专业级图表。本文将全面介绍 D2 的各种安装方式，帮助不同操作系统和环境的用户顺利安装使用这款强大的工具。

推荐安装方式：安装脚本

对于大多数用户来说，使用官方提供的安装脚本是最简单便捷的方式。该脚本会自动检测您的操作系统和架构，并选择最适合的安装方法。

安装脚本使用步骤

试运行模式（推荐先执行此步骤查看安装过程）：

curl -fsSL https://d2lang.com/install.sh | sh -s -- --dry-run

实际安装（确认无误后执行）：

curl -fsSL https://d2lang.com/install.sh | sh -s --

安装脚本特性

自动检测系统环境
遵循 XDG 标准规范
提供详细的帮助文档（通过 --help 参数查看）
支持指定安装版本（使用 --version 参数）
可同时安装 TALA 布局引擎（使用 --tala 参数）
允许自定义安装路径（使用 --prefix 参数）

安全性说明

虽然安装脚本不是最安全的安装方式（最安全的方式是使用系统包管理器或从源码编译），但脚本编写严谨，采用了多项安全措施：

全程使用 set -eu 确保错误处理
严格的引号使用规范
避免部分执行风险
即将添加的签名验证功能（目前正在开发中）

各平台专用安装方法

macOS 系统

Homebrew 用户可以直接使用以下命令安装：

brew install d2

如需从源码安装最新开发版：

brew install d2 --HEAD

Linux 系统

Void Linux 用户

xbps-install d2

独立发行版安装

D2 为每个版本提供独立的发行包，适合需要手动控制的用户。

基本安装流程

VERSION=v0.0.13 OS=macos ARCH=amd64 curl -fsSLO \
    "https://github.com/terrastruct/d2/releases/download/$VERSION/d2-$VERSION-$OS-$ARCH.tar.gz" \
    && tar -xzf "d2-$VERSION-$OS-$ARCH.tar.gz" \
    && make -sC "d2-$VERSION" install

自定义安装路径

make install PREFIX=$HOME/.local

从源码编译安装

使用 Go 工具链

要求 Go 1.20 或更高版本：

go install oss.terrastruct.com/d2@latest

从源码发行版安装

./ci/release/build.sh --install

Windows 系统支持

MSI 安装包

Windows 用户可以直接下载 .msi 安装包，安装程序会自动将 D2 添加到系统 PATH 中。

MSYS2/Git Bash 环境

在 MSYS2 环境下，可以使用与 Unix 系统类似的安装方式：

下载对应版本的压缩包
使用 make install 命令安装

WSL 支持

在 Windows Subsystem for Linux 中，可以像普通 Linux 系统一样安装 D2。

包管理器支持

Scoop

scoop install main/d2

Chocolatey

choco install d2

Docker 容器化部署

D2 提供官方 Docker 镜像，支持 amd64 和 arm64 架构。

基本使用示例

echo 'x -> y' >helloworld.d2
docker run --rm -it -u "$(id -u):$(id -g)" -v "$PWD:/home/debian/src" \
  -p 127.0.0.1:8080:8080 terrastruct/d2:v0.1.2 --watch helloworld.d2