DXVK着色器缓存路径配置：自定义存储位置

DXVK着色器缓存路径配置：自定义存储位置

【免费下载链接】dxvk Vulkan-based implementation of D3D9, D3D10 and D3D11 for Linux / Wine 项目地址: https://gitcode.com/gh_mirrors/dx/dxvk

引言：为什么需要自定义着色器缓存路径？

着色器缓存（Shader Cache）是DXVK（DirectX Vulkan）实现的关键组件，它将编译后的着色器程序存储在磁盘上，以避免每次运行应用程序时重新编译，从而显著减少加载时间和卡顿现象。默认情况下，DXVK会将着色器缓存文件存储在系统默认位置，但在某些场景下，用户可能需要自定义存储路径：

• 磁盘空间管理：系统盘空间不足时，将缓存转移到其他大容量存储设备
• 性能优化：将缓存存储在SSD以提高加载速度
• 多用户环境：为不同用户配置独立的缓存空间
• 备份与迁移：便于缓存的备份和迁移

本文将详细介绍如何在Linux/Wine环境下配置DXVK着色器缓存路径，包括临时配置、永久配置以及高级管理技巧。

DXVK着色器缓存路径配置方法

1. 环境变量临时配置法

DXVK提供了DXVK_SHADER_CACHE_PATH环境变量，允许用户临时指定着色器缓存的存储路径。这种方法适用于单次运行或测试不同缓存位置的场景。

使用方法： 在启动Wine应用程序前设置环境变量：

# 导出环境变量，指定缓存路径
export DXVK_SHADER_CACHE_PATH="/path/to/your/custom/shader/cache"

# 启动Wine应用程序（以notepad.exe为例）
wine notepad.exe

或者直接在命令行中组合使用：

DXVK_SHADER_CACHE_PATH="/path/to/your/custom/shader/cache" wine notepad.exe

适用场景：

• 临时测试不同缓存路径的性能影响
• 为特定应用程序单独配置缓存路径
• 不需要永久修改系统配置的场景

2. 配置文件永久配置法

对于需要永久生效的配置，推荐使用DXVK配置文件（dxvk.conf）。这种方法可以为所有应用程序或特定应用程序设置固定的缓存路径。

2.1 全局配置（适用于所有应用程序）

1. 定位或创建dxvk.conf文件

   DXVK会按以下顺序查找配置文件：

   • 应用程序可执行文件所在目录
   • 当前工作目录
   • 用户主目录下的.config/dxvk/目录
   • 系统级配置目录（如/etc/dxvk/）

   对于全局配置，推荐将配置文件放在用户主目录的.config/dxvk/目录下：

   # 创建配置目录（如果不存在）
   mkdir -p ~/.config/dxvk/
   
   # 创建或编辑配置文件
   nano ~/.config/dxvk/dxvk.conf
   

2. 添加缓存路径配置

   在dxvk.conf文件中添加以下内容：

   # 设置全局着色器缓存路径
   dxvk.shaderCachePath = /path/to/your/custom/shader/cache
   

   保存并退出编辑器。

2.2 特定应用程序配置

如果需要为特定应用程序设置独立的着色器缓存路径，可以在应用程序可执行文件所在目录创建dxvk.conf文件：

# 进入应用程序目录（以Steam游戏为例）
cd ~/.wine/drive_c/Program\ Files/Steam/steamapps/common/GameName/

# 创建配置文件
nano dxvk.conf

添加与全局配置相同的内容：

# 为特定应用程序设置着色器缓存路径
dxvk.shaderCachePath = /path/to/your/custom/shader/cache

2.3 配置文件格式说明

dxvk.conf采用简单的键值对格式，每行一个配置项：

# 这是注释行，以#开头

# 配置项格式：键名 = 值
dxvk.shaderCachePath = /path/to/your/custom/shader/cache

# 其他相关配置项
dxvk.shaderCache = True          # 启用着色器缓存（默认启用）
dxvk.shaderCacheValidation = True # 启用缓存验证（默认启用）

注意事项：

• 路径中包含空格时，需要使用引号包裹：dxvk.shaderCachePath = "/path/to/your custom/shader cache"
• 确保指定的目录存在且具有写入权限
• 配置文件中的注释行以#开头

3. Wine前缀（Prefix）配置法

在Wine环境中，可以为不同的Wine前缀（Prefix）配置独立的DXVK着色器缓存路径。这种方法适用于需要隔离不同应用程序环境的场景。

实现步骤：

1. 创建或使用现有Wine前缀

   # 创建新的Wine前缀
   WINEPREFIX="$HOME/.wine-custom" wineboot
   

2. 在Wine前缀中配置DXVK

   创建或编辑Wine前缀中的DXVK配置文件：

   # 进入Wine前缀的dxvk配置目录
   mkdir -p "$HOME/.wine-custom/drive_c/users/$USER/Local Settings/Application Data/dxvk"
   
   # 创建配置文件
   nano "$HOME/.wine-custom/drive_c/users/$USER/Local Settings/Application Data/dxvk/dxvk.conf"
   

3. 添加缓存路径配置

   # Wine前缀专用着色器缓存路径
   dxvk.shaderCachePath = /path/to/your/custom/shader/cache
   

4. 使用该Wine前缀运行应用程序

   WINEPREFIX="$HOME/.wine-custom" wine /path/to/application.exe
   

着色器缓存目录结构解析

配置自定义路径后，DXVK会在指定位置创建以下目录结构：

/path/to/your/custom/shader/cache/
├── dxvk-cache/           # 主缓存目录
│   ├── [游戏ID]/         # 每个游戏/应用程序独立的缓存子目录
│   │   ├── state.cache   # 着色器状态缓存
│   │   ├── dxvk-cache.0  # 着色器数据缓存文件（可能有多个）
│   │   └── dxvk-cache.1
└── dxvk-cache.lock       # 缓存锁定文件，防止并发写入冲突

关键文件说明：

• state.cache：存储着色器编译状态信息
• dxvk-cache.*：存储实际的编译后着色器二进制数据
• dxvk-cache.lock：缓存访问锁定文件，确保多进程安全

高级管理：着色器缓存的维护与优化

1. 缓存清理与重置

当着色器缓存损坏或导致图形问题时，可能需要清理缓存：

# 删除整个着色器缓存目录
rm -rf /path/to/your/custom/shader/cache/dxvk-cache/*

# 仅删除特定游戏的缓存
rm -rf /path/to/your/custom/shader/cache/dxvk-cache/[游戏ID]

2. 缓存迁移与备份

着色器缓存可以在不同系统间迁移，以避免重新编译：

# 备份缓存
tar -czvf dxvk-shader-cache-backup.tar.gz /path/to/your/custom/shader/cache

# 恢复缓存到新系统
tar -xzvf dxvk-shader-cache-backup.tar.gz -C /path/to/new/shader/cache

3. 缓存大小限制

虽然DXVK本身没有提供直接限制缓存大小的配置，但可以通过以下方法间接控制：

# 创建系统定时任务，定期清理超过指定大小的缓存
# 例如，使用find命令删除超过30天未访问的文件
find /path/to/your/custom/shader/cache -type f -atime +30 -delete

4. 性能监控与调优

可以通过设置DXVK_HUD环境变量监控着色器缓存性能：

# 显示着色器缓存统计信息
DXVK_HUD=shaderCache wine notepad.exe

HUD将显示以下信息：

• 缓存命中率（Cache Hit Rate）
• 缓存大小（Cache Size）
• 编译着色器数量（Compiled Shaders）

常见问题解决

Q1: 设置自定义路径后，着色器缓存没有生成？

可能原因与解决方案：

1. 路径权限不足：确保指定的目录具有写入权限

   chmod -R 755 /path/to/your/custom/shader/cache
   

2. 路径不存在：手动创建目录

   mkdir -p /path/to/your/custom/shader/cache
   

3. 配置文件位置错误：确认dxvk.conf文件放置在正确的位置

4. 配置项拼写错误：检查配置项是否正确，应为dxvk.shaderCachePath

Q2: 迁移缓存后，应用程序启动时仍然重新编译着色器？

可能原因与解决方案：

1. 缓存不兼容：不同DXVK版本之间的缓存可能不兼容，需要更新DXVK或删除旧缓存
2. 权限问题：确保新系统中的缓存目录具有正确的权限
3. 游戏版本变化：游戏更新可能导致着色器变化，需要部分或全部重新编译

Q3: 如何确认自定义缓存路径是否生效？

验证方法：

1. 查看HUD信息：启用DXVK_HUD查看缓存路径

   DXVK_HUD=shaderCache wine notepad.exe
   

2. 检查文件创建：启动应用程序后，检查自定义路径下是否生成了缓存文件

   ls -la /path/to/your/custom/shader/cache
   

总结与展望

自定义DXVK着色器缓存路径是优化游戏体验和系统管理的重要手段。通过本文介绍的三种方法——环境变量临时配置、配置文件永久配置和Wine前缀配置，用户可以根据实际需求灵活设置缓存路径。同时，合理的缓存管理策略（清理、备份、迁移）能够进一步提升系统性能和用户体验。

随着DXVK项目的不断发展，未来可能会提供更多高级的缓存管理功能，如自动缓存大小控制、智能预编译等。用户可以通过关注DXVK项目的更新日志获取最新信息。

附录：DXVK着色器缓存相关配置项完整列表

以下是dxvk.conf中与着色器缓存相关的配置项：

配置项	默认值	说明
dxvk.shaderCachePath	系统默认路径	着色器缓存存储路径
dxvk.shaderCache	True	启用/禁用着色器缓存
dxvk.shaderCacheValidation	True	启用/禁用缓存验证
dxvk.shaderCacheCompression	True	启用/禁用缓存压缩
dxvk.numCompilerThreads	0	着色器编译线程数（0表示使用所有可用核心）

要获取DXVK的最新版本和更多配置选项，请访问项目仓库：https://gitcode.com/gh_mirrors/dx/dxvk

【免费下载链接】dxvk Vulkan-based implementation of D3D9, D3D10 and D3D11 for Linux / Wine 项目地址: https://gitcode.com/gh_mirrors/dx/dxvk