WezTerm中PowerShell工作目录同步问题的解决方案

问题背景

在使用WezTerm终端模拟器时，Windows用户在使用PowerShell时可能会遇到一个常见问题：当通过快捷键垂直或水平分割窗格时，新创建的窗格无法正确继承当前工作目录(CWD)。相反，新窗格有时会跳转到用户主目录(~/)或其他意外位置(如~/.ssh)。

问题分析

这个问题在Windows平台上特别明显，尤其是在使用PowerShell作为默认shell时。相比之下，使用传统的cmd.exe时工作目录继承功能表现正常。这表明问题可能与PowerShell的特定行为或WezTerm与PowerShell的交互方式有关。

根本原因

经过技术分析，发现问题的核心在于WezTerm需要依赖shell集成功能来正确跟踪和同步工作目录。对于PowerShell，需要显式配置以发送特定的Shell Integration转义序列(特别是OSC 7序列)，这样WezTerm才能准确获取和设置工作目录。

解决方案

方法一：配置PowerShell Shell Integration

1. 修改PowerShell配置文件($PROFILE)，添加以下函数：

function prompt {
    $loc = $($executionContext.SessionState.Path.CurrentLocation);
    $out = "PS $loc$('>' * ($nestedPromptLevel + 1)) ";
    [Console]::Write("`e]7;file://${env:COMPUTERNAME}/${loc}`a");
    return $out
}

2. 这个函数会在每次提示符显示时发送OSC 7序列，通知WezTerm当前的工作目录

方法二：结合Oh My Posh的解决方案

对于使用Oh My Posh主题的用户，可以采用以下配置：

1. 在PowerShell配置文件中添加：

function Global:Prompt {
    $loc = $executionContext.SessionState.Path.CurrentLocation
    $prompt = & oh-my-posh print primary --config ~/jandedobbeleer.omp.json
    [Console]::Write("`e]7;file://${env:COMPUTERNAME}/${loc}`a")
    return $prompt
}

2. 这种方法既保留了Oh My Posh的美观主题，又实现了工作目录同步功能

技术原理

OSC 7(Operating System Command 7)是一种终端控制序列，专门用于传递工作目录信息。格式为：

ESC ] 7 ; file://hostname/path BEL

其中：

• ESC是转义字符(\x1b)
• ]7;表示OSC 7序列开始
• file://hostname/path是当前工作目录的URI格式
• BEL是响铃字符(\a)

WezTerm会解析这个序列并据此设置新窗格的初始工作目录。

注意事项

1. 确保配置文件有正确的执行权限
2. 修改后需要重新加载配置文件或重启WezTerm
3. 如果同时使用其他PowerShell主题或提示符定制工具，可能需要调整集成方式
4. 在跨平台使用时，注意路径格式的兼容性

总结

通过正确配置PowerShell的Shell Integration功能，可以完美解决WezTerm中工作目录同步的问题。这不仅能改善垂直/水平分割时的用户体验，也为其他依赖工作目录的终端功能提供了更好的支持。对于高级用户，还可以将此方案与其他PowerShell定制工具(如Oh My Posh)结合使用，既保持美观又确保功能完整。