目录{#directories}

Tuist 遵循 XDG 基本目录规范，在系统中的多个目录中组织文件。这为管理配置、缓存和状态文件提供了一种简洁、标准的方式。

支持的环境变量{#supported-environment-variables}

Tuist 既支持标准 XDG 变量，也支持 Tuist 特有的前缀变量。Tuist 专用变量（前缀为TUIST_ ）优先，允许您将 Tuist 与其他应用程序分开配置。

配置目录{#configuration-directory}

环境变量：

TUIST_XDG_CONFIG_HOME （优先）。
xdg_config_home

默认值： ~/.config/tuist

用于：

服务器凭据 (credentials/{host}.json)

例如

bash

# Set Tuist-specific config directory
export TUIST_XDG_CONFIG_HOME=/custom/config
tuist auth login

# Or use standard XDG variable
export XDG_CONFIG_HOME=/custom/config
tuist auth login

缓存目录{#cache-directory}

环境变量：

TUIST_XDG_CACHE_HOME （优先）。
XDG_CACHE_HOME

默认值： ~/.cache/tuist

用于：

插件：已下载和编译的插件缓存
ProjectDescriptionHelpers ：编译的项目描述助手
清单：缓存清单文件
项目：生成自动化项目缓存
编辑项目 ：编辑命令缓存
运行：测试和构建运行分析数据
二进制文件 ：构建工件二进制文件（不可跨环境共享）
SelectiveTests ：选择性测试缓存

例如

bash

# Set Tuist-specific cache directory
export TUIST_XDG_CACHE_HOME=/tmp/tuist-cache
tuist cache

# Or use standard XDG variable
export XDG_CACHE_HOME=/tmp/cache
tuist cache

国家目录{#state-directory}

环境变量：

TUIST_XDG_STATE_HOME （优先使用）
XDG_STATE_HOME

默认值： ~/.local/state/tuist

用于：

日志：日志文件 (logs/{uuid}.log)
锁：身份验证锁文件 ({handle}.sock)

例如

bash

# Set Tuist-specific state directory
export TUIST_XDG_STATE_HOME=/var/log/tuist
tuist generate

# Or use standard XDG variable
export XDG_STATE_HOME=/var/log
tuist generate

优先顺序{#precedence-order}

在确定使用哪个目录时，Tuist 会按以下顺序检查环境变量：

特定于 Tuist 的变量 （例如，TUIST_XDG_CONFIG_HOME)
标准 XDG 变量 （如XDG_CONFIG_HOME)
默认位置 （例如，~/.config/tuist)

这样您就可以

使用标准的 XDG 变量来统一组织所有应用程序
当需要 Tuist 的不同位置时，使用 Tuist 专用变量覆盖
依靠合理的默认设置，无需任何配置

常见用例{#common-use-cases}

按项目隔离图易斯特{#isolating-tuist-per-project}

您可能需要在每个项目中隔离 Tuist 的缓存和状态：

bash

# In your project's .envrc (using direnv)
export TUIST_XDG_CACHE_HOME="$PWD/.tuist/cache"
export TUIST_XDG_STATE_HOME="$PWD/.tuist/state"
export TUIST_XDG_CONFIG_HOME="$PWD/.tuist/config"

CI/CD 环境{#ci-cd-environments}

在 CI 环境中，您可能需要使用临时目录：

yaml

# GitHub Actions example
env:
  TUIST_XDG_CACHE_HOME: /tmp/tuist-cache
  TUIST_XDG_STATE_HOME: /tmp/tuist-state

jobs:
  build:
    runs-on: macos-latest
    steps:
      - uses: actions/checkout@v4
      - run: tuist generate
      - name: Upload logs
        if: failure()
        uses: actions/upload-artifact@v4
        with:
          name: tuist-logs
          path: /tmp/tuist-state/logs/*.log

使用隔离目录进行调试{#debugging-with-isolated-directories}

在调试问题时，你可能需要一块干净的石板：

bash

# Create temporary directories for debugging
export TUIST_XDG_CACHE_HOME=$(mktemp -d)
export TUIST_XDG_STATE_HOME=$(mktemp -d)
export TUIST_XDG_CONFIG_HOME=$(mktemp -d)

# Run Tuist commands
tuist generate

# Clean up when done
rm -rf $TUIST_XDG_CACHE_HOME $TUIST_XDG_STATE_HOME $TUIST_XDG_CONFIG_HOME