BG3ModManager在Linux环境下工作目录问题的分析与解决

BG3ModManager在Linux环境下工作目录问题的分析与解决

BG3ModManager A mod manager for Baldur's Gate 3. 项目地址: https://gitcode.com/gh_mirrors/bg/BG3ModManager

背景介绍

BG3ModManager是一款为《博德之门3》设计的模组管理工具，近期在升级到1.0.21.1版本后，Linux用户通过Proton运行时发现了一个与工作目录相关的问题。该问题导致管理器在某些情况下会将数据文件写入到非预期的目录位置。

问题现象

在Linux系统下通过Proton运行BG3ModManager时，工具会将Orders目录创建在当前工作目录而非安装目录下。这一行为变化发生在从.NET 4.7.2升级到.NET 8.0之后，可能与两个框架版本在处理路径获取方式上的差异有关。

技术分析

经过代码审查发现，问题源于路径获取逻辑的不一致性：

1. 正确路径获取方式：工具中大部分功能使用DivinityApp.GetAppDirectory()方法获取安装目录路径
2. 问题代码段：Orders目录的路径处理直接使用了相对路径"Orders"，没有经过安装目录路径的拼接

在.NET框架中，AppDomain.CurrentDomain.BaseDirectory在Windows环境下总能正确返回应用程序所在目录，但在Proton环境下，这一行为可能有所不同，导致路径解析出现偏差。

解决方案

开发者通过以下方式修复了该问题：

1. 统一使用DivinityApp.GetAppDirectory()方法获取基础路径
2. 对相对路径进行规范化处理，确保其基于安装目录而非当前工作目录
3. 修复了默认路径设置逻辑，避免空值或空白路径导致的意外行为

用户影响

这一修复确保了：

• 配置文件仍存储在预期位置
• Orders目录现在会正确创建在安装目录下
• 工具能够正确识别和加载之前的模组排序配置

最佳实践建议

对于Linux用户，特别是通过Proton运行BG3ModManager的情况，建议：

1. 确保使用最新版本的管理器(1.0.12.3或更高)
2. 可以通过环境变量强制指定工作目录
3. 检查数据文件是否存储在预期位置

总结

这次问题修复展示了跨平台开发中路径处理的复杂性，特别是在不同.NET版本和运行环境下的行为差异。通过统一路径获取方式和加强路径处理逻辑，BG3ModManager现在能够在Linux环境下更可靠地工作，为用户提供一致的体验。

BG3ModManager A mod manager for Baldur's Gate 3. 项目地址: https://gitcode.com/gh_mirrors/bg/BG3ModManager