NavigationSplitView侧边栏无法应用指定tint颜色问题求助

核心原因 #

NavigationSplitView的侧边栏（List组件）默认选中样式并未直接绑定AccentColor或.tint()配置，尤其是macOS平台下，系统默认的侧边栏高亮样式会优先读取系统偏好设置，即便你在项目内修改了AccentColor也无法覆盖。必须显式自定义List的选中项样式才能生效。

具体解决步骤 #

1. 先确认基础配置无错误 #

• 检查Assets.xcassets中的AccentColor：确保普通/深色模式下都设置为红色，没有误配置其他颜色。
• 检查项目Info.plist：若存在NSAccentColorName键，删除该键或改为你的红色资源名称，避免覆盖自定义配置。

2. 自定义侧边栏List的选中样式 #

直接给侧边栏的List行添加选中状态的样式控制，示例代码如下：

假设原代码结构：

NavigationSplitView {
    List(selection: $selectedItem) {
        ForEach(items) { item in
            NavigationLink(value: item) {
                Text(item.name)
            }
        }
    }
    .navigationTitle("侧边栏")
    .tint(.red) // 之前无效的设置
} detail: {
    // 详情视图内容
}

修改为：

NavigationSplitView {
    List(selection: $selectedItem) {
        ForEach(items) { item in
            NavigationLink(value: item) {
                Text(item.name)
            }
            // 自定义选中行的背景色
            .listRowBackground(selectedItem == item ? Color.red.opacity(0.2) : Color.clear)
            // 自定义选中行的文字颜色
            .foregroundColor(selectedItem == item ? .red : .primary)
        }
    }
    .navigationTitle("侧边栏")
    // 可选：设置List分隔线颜色
    .listRowSeparatorTint(.red)
} detail: {
    // 详情视图内容
}

3. macOS平台额外处理 #

如果是macOS项目，系统自带侧边栏高亮样式会干扰自定义效果，可先禁用再自定义：

List(selection: $selectedItem) {
    // 侧边栏内容
}
// 启用系统侧边栏样式并禁用默认背景
.listStyle(.sidebar)
.scrollContentBackground(.hidden)
.background(Color.clear)

4. 全局统一样式（可选） #

若想让所有侧边栏复用该样式，可创建自定义ListStyle：

struct CustomSidebarListStyle: ListStyle {
    func makeBody(configuration: Configuration) -> some View {
        List(configuration) { item in
            item
                .foregroundColor(configuration.isSelected(item) ? .red : .primary)
                .listRowBackground(configuration.isSelected(item) ? Color.red.opacity(0.2) : Color.clear)
        }
        .listStyle(.sidebar)
        .scrollContentBackground(.hidden)
    }
}

// 使用时直接调用
List(...) { ... }
.listStyle(CustomSidebarListStyle())

为什么之前的.tint()无效？ #

.tint()主要作用于按钮、导航栏控件、TabView等交互式组件的颜色，而NavigationSplitView侧边栏的List选中状态属于List行的样式范畴，并不受.tint()直接控制，因此需要单独自定义行的外观。

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