在 Windows 11 上还原 direnv 设置的路径格式
内容提要
文章介绍在 Windows 11 上使用 direnv 时，.envrc 设置的 PATH 会变成 Windows 格式而非 Unix 格式。作者建议不直接添加 direnv hook bash，而是修改其输出，在 direnv 设置环境后调用 cygpath -p 转换 PATH 等路径变量；需转换的变量名由 _unmangle_direnv_names 指定，默认为 PATH，可追加其他变量。
延伸解读
问题根源：direnv 输出的是 Windows 格式路径
文章指出，direnv 在 Windows 11 上本身可以正常工作，但一旦 .envrc 尝试设置 PATH，导出的结果就是 Windows 格式路径，而不是 Bash 环境期望的 Unix 格式。这会导致在 Git Bash、mintty 等环境中 PATH 解析异常。作者引用的两个 direnv issue 也说明这是长期存在的兼容性问题，而非个别配置失误。
解决思路：在 hook 之后追加转换步骤
作者没有直接使用 eval $(direnv hook bash)，而是用 sed 修改 hook 输出，在 direnv 设置完环境后插入 _unmangle_direnv_paths 函数调用。该函数遍历指定变量，用 /usr/bin/cygpath -p 把 Windows 路径转换为 Unix 格式。这种做法的好处是不改动 direnv 本身，只在 shell 层做后处理，升级 direnv 时影响较小。
可扩展的变量名单
需要转换的变量由 _unmangle_direnv_names 控制，默认只包含 PATH，多个变量用空格分隔。如果某个 .envrc 还设置了其他路径类变量，例如示例中的 XPATH，可以把它追加到该名单中，从而一并完成格式转换。这意味着方案并非只针对 PATH 写死，而是提供了按需扩展的机制，读者可根据自己的 .envrc 内容调整。
实践提示与局限
该方案依赖 cygpath，因此适用于带有 Cygwin/MSYS 工具链的 Bash 环境，如 Git Bash。它通过字符串替换修改 hook 输出，若 direnv 未来改变 hook 文本格式，sed 匹配可能失效，需要重新检查。作者还提到实验中发现 direnv export json，认为结构化输入输出更利于工具集成，可作为进一步探索的方向。
Q&A
在 Windows 11 上用 direnv 时，.envrc 设置的 PATH 为什么会变成 Windows 格式？
因为 direnv 在 Windows 上运行时，会将 PATH 等路径变量导出为 Windows 格式（如 C:\...），而不是 Unix 格式（如 /c/...），导致在 bash 环境中路径解析出错。
如何修改 direnv hook bash 的输出以自动转换路径格式？
不直接使用 eval $(direnv hook bash)，而是通过 sed 在 hook 输出中插入 _unmangle_direnv_paths 函数调用，该函数会在 direnv 设置环境后使用 cygpath -p 转换指定变量的路径格式。
_unmangle_direnv_names 变量有什么作用？如何自定义需要转换的变量？
_unmangle_direnv_names 是一个空格分隔的变量名列表，指定哪些环境变量需要被转换。默认只包含 PATH。若要转换其他变量（如 XPATH），可将其追加到该变量中，例如 _unmangle_direnv_names="$_unmangle_direnv_names XPATH"。
转换路径时使用了哪个命令？它有什么作用？
使用了 cygpath -p 命令，它可以将 Windows 格式的路径列表转换为 Unix 格式，从而修复 PATH 等变量的格式。
除了 PATH，还能转换其他环境变量吗？如何操作？
可以。只需将变量名添加到 _unmangle_direnv_names 中（空格分隔），例如添加 XPATH 后，在 .envrc 中设置 XPATH 也会被自动转换。
这个方案适用于哪些环境？
适用于 Windows 11 上使用 bash（如 Git Bash 或 Cygwin）并配合 direnv 的场景，需要 cygpath 命令可用。
