如何用 Git worktree 和 phw 为 PostHog 创建多分支隔离开发环境【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog如果你需要同时开发 PostHog 的多个分支——比如一边做新功能、一边修紧急 bug、还要顺手 review 同事的 PR——在主仓库里来回git checkout会丢掉现场的依赖状态和环境。PostHog 仓库自带phw工具bin/phw实际逻辑在 bin/posthog-worktree它基于 Git worktree 为每个分支创建独立目录并通过 direnv .envrc在进入目录时自动激活该 worktree 自己的 Flox 环境和 Python venv。这篇文章基于仓库内的 Flox 多实例工作流文档 和 本地开发指南说明如何一次性配好环境之后用phw create/checkout/switch/pr在多个隔离分支间切换。先明确一条限制同一时间只能跑一个 PostHog 实例hogli start因为所有 worktree 共用相同的端口。这套工作流的定位是快速停掉一个实例、切到另一个 worktree、再起一个而不是同时并行运行多个实例。适用前提以下前提来自官方文档开始前逐项确认已完成 PostHog 本地开发环境搭建能运行hogli start即已经装好 Flox 并在主仓库里flox activate成功。搭建方法见 developing-locally.md。已安装 Flox安装方式见 Flox 官方文档。Git 支持 worktreesGit 2.5。如需phw pr拉取 PR 到 worktree需要 GitHub CLIgh和jq。推荐安装 direnv用于进入 worktree 目录时自动激活 Flox 环境。其中 3 项依赖在 macOS 上可用一条命令安装注意副作用这会在你的机器上安装direnv、gh、jq三个工具brew install direnv gh jq一次性设置文档要求示例中的~/dev/posthog/posthog都替换为你本机的 PostHog 仓库路径。完整的一次性设置流程# 安装依赖如上面已装过可跳过 brew install direnv gh jq # 把 direnv hook 加入 shell 配置zsh 用户bash 用户把 zsh 换成 bash eval $(direnv hook zsh) # 写入 ~/.zshrc source ~/.zshrc # 在主仓库中验证 Flox 环境可用 cd ~/dev/posthog/posthog flox activateflox activate成功时你会看到 Flox 环境被激活、uv sync运行Python 依赖每次激活时都会同步JS 依赖仅在node_modules/不存在时安装。这一步是后续所有phw操作的基础——phw函数本身就是由 Flox 环境激活时加载的见 .flox/env/manifest.toml 中source $FLOX_ENV_PROJECT/bin/phw的加载逻辑。可选自定义 worktree 存放位置默认情况下 worktree 创建在~/.worktrees/posthog/。想换位置就在 shell 配置文件~/.zshrc或~/.bashrc中设置export POSTHOG_WORKTREE_BASE$HOME/code/worktrees # Worktrees will be created in ~/code/worktrees/branch-name注意phw list和phw remove基于 Git 原生的 worktree 跟踪git worktree list所以即使后来改了POSTHOG_WORKTREE_BASE旧位置的 worktree 依然能列出和删除。轻量 worktree不跑应用时的简化路径如果你只是要编辑和提交代码、不需要在 worktree 里运行应用文档指出不必走完整的phw流程一条原生命令就够git worktree add path branchPre-commit hookslint-staged、hogli、ruff、ty开箱即用它们会自动借用主 clone 的node_modules和 Python venv前提是该 worktree 的pnpm-lock.yaml和uv.lock与主 clone 一致lockfile 不一致时 hooks 会提示你在本地安装。借用只持续一次 hook 进程worktree 本身没有独立的node_modules或 venv所以编辑器、类型检查和测试需要先在 worktree 里flox activate。另外借用的是主 clone 里的一方代码hogli、posthog/*解析到主 clone 而非你的分支因此在修改hogli或 workspace 包之前务必先在 worktree 里flox activate。日常操作用 phw 创建与切换分支设置完成后所有操作都通过phw完成。命令速查默认基分支为masterphw create branch [base-branch] # 创建新分支 worktree默认基于 master phw checkout branch # 为已有分支创建 worktree phw switch branch # 切换到已存在的 worktree phw pr number # 把 PR 拉取到 worktree phw remove branch # 删除 worktree phw list # 列出所有 worktreephw create/checkout执行成功后会自动cd进 worktree 并激活 Floxphw函数的 auto-cd 行为见 bin/phw。创建新分支# 基于 master 创建分支 new-feature 和对应 worktree phw create haacked/new-feature # 此时已在 worktree 内且 Flox 已激活 hogli start # 访问 http://localhost:8010 # 指定其他基分支 phw create haacked/new-feature master检出已有分支 / 切换已存在的 worktreephw checkout haacked/new-feature # 为已有分支创建 worktreeFlox 已激活 phw switch haacked/new-feature # 切换到已创建的 worktreeFlox 已激活在 worktree 中 review PRphw pr 12345 # 拉取 PR、切换到 worktree hogli start # 在 http://localhost:8010 上验证一条完整的切换链路文档示例场景下面这段是文档给出的真实工作流注意每次切换前先停掉当前实例# 开始新功能 phw create haacked/analytics-dashboard hogli migrations:run # 运行迁移 hogli start # 启动开发 # 紧急 bug先 CtrlC 停掉 hogli start phw checkout master git pull origin master hogli start # Review 同事的 PR先停掉当前实例 phw pr 5678 hogli start # 回到功能分支先停实例再切换 phw switch haacked/analytics-dashboard hogli start # 收尾清理 phw list phw remove pr-5678-teammate # PR review 完毕删除对应 worktree验证环境是否正确工作看 worktree 清单。phw list输出所有 PostHog worktrees不区分创建位置文档中的示例输出# All PostHog Worktrees: # # Branch Path Location # ------ ---- -------- # haacked/improved-workflow /Users/username/dev/posthog/posthog other # haacked/analytics-dashboard /Users/username/.worktrees/posthog/haacked/... current # main /Users/username/.worktrees/posthog/main current # pr-5678-teammate /Users/username/.worktrees/posthog/pr-5678-... current # # Legend: # current in current worktree base (/Users/username/.worktrees/posthog) # other in different location以上为文档示例输出你的路径和分支名会不同。current表示位于当前 worktree base 内other表示在别的位置。确认 Flox 环境已随目录切换。每个 worktree 有自己的.flox/env/manifest.toml和 Python venvphw创建 worktree 时会复制.envrc进入目录后 direnv 检测到.envrc即自动激活 Flox 并运行uv sync。文档给出的完整链路是phw create branch → creates worktree → copies .envrc → cd to worktree → direnv detects .envrc → activates Flox → runs uv sync → ready to code!确认应用能跑起来。在 worktree 内hogli start后访问 http://localhost:8010 能看到 PostHog 应用即表示该 worktree 的环境完整可用。切换时的嵌套环境提示在已处于一个 Flox 环境时切换到另一个 worktree.envrc会弹出一个交互提示防止意外嵌套环境该逻辑就写在仓库根目录的 .envrc 中⚠️ About to activate Flox environment in worktree while already in environment for: /Users/username/dev/posthog/posthog Continue with nested activation? (y/N):三个选择文档原文按 Enter 或n推荐跳过激活。先执行exit退出当前环境Flox 会干净地切换。输入y继续嵌套激活之后需要多次exit才能全部退出。CtrlC完全取消 direnv之后可以exit再重试。文档给出的最佳实践是先退出再切换exit # 离开当前 Flox 环境 cd ~/.worktrees/posthog/my-branch # 切换到 worktree # Flox 干净激活无嵌套提示清理 worktreephw remove branch会删除对应 worktree注意副作用底层执行git worktree remove path --force该分支的 worktree 目录会被移除见 bin/posthog-worktree且不受 worktree 存放位置影响# 删除指定 worktree phw remove haacked/old-feature # 清理 git 遗留的 worktree 引用文档标注可安全运行 git worktree prune日常调试还可以用flox list # 查看 Flox 环境状态 flox search --installed # 查看当前环境安装了什么 git worktree list # 原生查看当前 worktrees常见故障排查direnv 不激活。在 worktree 中手动放行并检查 hookphw switch your-branch direnv allow which direnv # 应显示 /opt/homebrew/bin/direnv 之类 echo $DIRENV_DIR # 在 direnv 目录内应有输出Flox 激活失败。先信任环境仍失败时可重装该 worktree 的 Flox 环境注意副作用rm -rf .flox会删除当前 worktree 的.flox目录再从不包含未提交 Flox 配置的仓库主 clone 复制环境目录过去之后需重新flox activateflox activate --trust # 或 rm -rf .flox cp -r ~/dev/posthog/posthog/.flox/env .flox/ flox activatephw命令找不到。确认 Flox 环境已激活phw由 Flox 激活钩子加载cd ~/dev/posthog/posthog flox activate依赖不同步。在 Flox 环境中强制重装flox activate -- uv sync --reinstall限制与下一步端口冲突是固有限制所有 worktree 共用相同端口同一时间只能hogli start一个实例切换时先用 CtrlC 停掉当前实例。phw pr依赖gh和jq--dir参数可为phw create指定不同于分支名的目录名。phw create会在创建前清理同名残留目录它先执行git worktree prune仅当 Git 不认为该目录仍是活跃 worktree 时才删除残留目录安全逻辑见 bin/posthog-worktree 中的cleanup_stale_worktree。环境层面的问题hogli start连接错误、端口占用、数据库迁移等按 developing-locally.md 的 Common gotchas 一节排查本文不重复。【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
如何用 Git worktree 和 phw 为 PostHog 创建多分支隔离开发环境？
如何用 Git worktree 和 phw 为 PostHog 创建多分支隔离开发环境【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog如果你需要同时开发 PostHog 的多个分支——比如一边做新功能、一边修紧急 bug、还要顺手 review 同事的 PR——在主仓库里来回git checkout会丢掉现场的依赖状态和环境。PostHog 仓库自带phw工具bin/phw实际逻辑在 bin/posthog-worktree它基于 Git worktree 为每个分支创建独立目录并通过 direnv .envrc在进入目录时自动激活该 worktree 自己的 Flox 环境和 Python venv。这篇文章基于仓库内的 Flox 多实例工作流文档 和 本地开发指南说明如何一次性配好环境之后用phw create/checkout/switch/pr在多个隔离分支间切换。先明确一条限制同一时间只能跑一个 PostHog 实例hogli start因为所有 worktree 共用相同的端口。这套工作流的定位是快速停掉一个实例、切到另一个 worktree、再起一个而不是同时并行运行多个实例。适用前提以下前提来自官方文档开始前逐项确认已完成 PostHog 本地开发环境搭建能运行hogli start即已经装好 Flox 并在主仓库里flox activate成功。搭建方法见 developing-locally.md。已安装 Flox安装方式见 Flox 官方文档。Git 支持 worktreesGit 2.5。如需phw pr拉取 PR 到 worktree需要 GitHub CLIgh和jq。推荐安装 direnv用于进入 worktree 目录时自动激活 Flox 环境。其中 3 项依赖在 macOS 上可用一条命令安装注意副作用这会在你的机器上安装direnv、gh、jq三个工具brew install direnv gh jq一次性设置文档要求示例中的~/dev/posthog/posthog都替换为你本机的 PostHog 仓库路径。完整的一次性设置流程# 安装依赖如上面已装过可跳过 brew install direnv gh jq # 把 direnv hook 加入 shell 配置zsh 用户bash 用户把 zsh 换成 bash eval $(direnv hook zsh) # 写入 ~/.zshrc source ~/.zshrc # 在主仓库中验证 Flox 环境可用 cd ~/dev/posthog/posthog flox activateflox activate成功时你会看到 Flox 环境被激活、uv sync运行Python 依赖每次激活时都会同步JS 依赖仅在node_modules/不存在时安装。这一步是后续所有phw操作的基础——phw函数本身就是由 Flox 环境激活时加载的见 .flox/env/manifest.toml 中source $FLOX_ENV_PROJECT/bin/phw的加载逻辑。可选自定义 worktree 存放位置默认情况下 worktree 创建在~/.worktrees/posthog/。想换位置就在 shell 配置文件~/.zshrc或~/.bashrc中设置export POSTHOG_WORKTREE_BASE$HOME/code/worktrees # Worktrees will be created in ~/code/worktrees/branch-name注意phw list和phw remove基于 Git 原生的 worktree 跟踪git worktree list所以即使后来改了POSTHOG_WORKTREE_BASE旧位置的 worktree 依然能列出和删除。轻量 worktree不跑应用时的简化路径如果你只是要编辑和提交代码、不需要在 worktree 里运行应用文档指出不必走完整的phw流程一条原生命令就够git worktree add path branchPre-commit hookslint-staged、hogli、ruff、ty开箱即用它们会自动借用主 clone 的node_modules和 Python venv前提是该 worktree 的pnpm-lock.yaml和uv.lock与主 clone 一致lockfile 不一致时 hooks 会提示你在本地安装。借用只持续一次 hook 进程worktree 本身没有独立的node_modules或 venv所以编辑器、类型检查和测试需要先在 worktree 里flox activate。另外借用的是主 clone 里的一方代码hogli、posthog/*解析到主 clone 而非你的分支因此在修改hogli或 workspace 包之前务必先在 worktree 里flox activate。日常操作用 phw 创建与切换分支设置完成后所有操作都通过phw完成。命令速查默认基分支为masterphw create branch [base-branch] # 创建新分支 worktree默认基于 master phw checkout branch # 为已有分支创建 worktree phw switch branch # 切换到已存在的 worktree phw pr number # 把 PR 拉取到 worktree phw remove branch # 删除 worktree phw list # 列出所有 worktreephw create/checkout执行成功后会自动cd进 worktree 并激活 Floxphw函数的 auto-cd 行为见 bin/phw。创建新分支# 基于 master 创建分支 new-feature 和对应 worktree phw create haacked/new-feature # 此时已在 worktree 内且 Flox 已激活 hogli start # 访问 http://localhost:8010 # 指定其他基分支 phw create haacked/new-feature master检出已有分支 / 切换已存在的 worktreephw checkout haacked/new-feature # 为已有分支创建 worktreeFlox 已激活 phw switch haacked/new-feature # 切换到已创建的 worktreeFlox 已激活在 worktree 中 review PRphw pr 12345 # 拉取 PR、切换到 worktree hogli start # 在 http://localhost:8010 上验证一条完整的切换链路文档示例场景下面这段是文档给出的真实工作流注意每次切换前先停掉当前实例# 开始新功能 phw create haacked/analytics-dashboard hogli migrations:run # 运行迁移 hogli start # 启动开发 # 紧急 bug先 CtrlC 停掉 hogli start phw checkout master git pull origin master hogli start # Review 同事的 PR先停掉当前实例 phw pr 5678 hogli start # 回到功能分支先停实例再切换 phw switch haacked/analytics-dashboard hogli start # 收尾清理 phw list phw remove pr-5678-teammate # PR review 完毕删除对应 worktree验证环境是否正确工作看 worktree 清单。phw list输出所有 PostHog worktrees不区分创建位置文档中的示例输出# All PostHog Worktrees: # # Branch Path Location # ------ ---- -------- # haacked/improved-workflow /Users/username/dev/posthog/posthog other # haacked/analytics-dashboard /Users/username/.worktrees/posthog/haacked/... current # main /Users/username/.worktrees/posthog/main current # pr-5678-teammate /Users/username/.worktrees/posthog/pr-5678-... current # # Legend: # current in current worktree base (/Users/username/.worktrees/posthog) # other in different location以上为文档示例输出你的路径和分支名会不同。current表示位于当前 worktree base 内other表示在别的位置。确认 Flox 环境已随目录切换。每个 worktree 有自己的.flox/env/manifest.toml和 Python venvphw创建 worktree 时会复制.envrc进入目录后 direnv 检测到.envrc即自动激活 Flox 并运行uv sync。文档给出的完整链路是phw create branch → creates worktree → copies .envrc → cd to worktree → direnv detects .envrc → activates Flox → runs uv sync → ready to code!确认应用能跑起来。在 worktree 内hogli start后访问 http://localhost:8010 能看到 PostHog 应用即表示该 worktree 的环境完整可用。切换时的嵌套环境提示在已处于一个 Flox 环境时切换到另一个 worktree.envrc会弹出一个交互提示防止意外嵌套环境该逻辑就写在仓库根目录的 .envrc 中⚠️ About to activate Flox environment in worktree while already in environment for: /Users/username/dev/posthog/posthog Continue with nested activation? (y/N):三个选择文档原文按 Enter 或n推荐跳过激活。先执行exit退出当前环境Flox 会干净地切换。输入y继续嵌套激活之后需要多次exit才能全部退出。CtrlC完全取消 direnv之后可以exit再重试。文档给出的最佳实践是先退出再切换exit # 离开当前 Flox 环境 cd ~/.worktrees/posthog/my-branch # 切换到 worktree # Flox 干净激活无嵌套提示清理 worktreephw remove branch会删除对应 worktree注意副作用底层执行git worktree remove path --force该分支的 worktree 目录会被移除见 bin/posthog-worktree且不受 worktree 存放位置影响# 删除指定 worktree phw remove haacked/old-feature # 清理 git 遗留的 worktree 引用文档标注可安全运行 git worktree prune日常调试还可以用flox list # 查看 Flox 环境状态 flox search --installed # 查看当前环境安装了什么 git worktree list # 原生查看当前 worktrees常见故障排查direnv 不激活。在 worktree 中手动放行并检查 hookphw switch your-branch direnv allow which direnv # 应显示 /opt/homebrew/bin/direnv 之类 echo $DIRENV_DIR # 在 direnv 目录内应有输出Flox 激活失败。先信任环境仍失败时可重装该 worktree 的 Flox 环境注意副作用rm -rf .flox会删除当前 worktree 的.flox目录再从不包含未提交 Flox 配置的仓库主 clone 复制环境目录过去之后需重新flox activateflox activate --trust # 或 rm -rf .flox cp -r ~/dev/posthog/posthog/.flox/env .flox/ flox activatephw命令找不到。确认 Flox 环境已激活phw由 Flox 激活钩子加载cd ~/dev/posthog/posthog flox activate依赖不同步。在 Flox 环境中强制重装flox activate -- uv sync --reinstall限制与下一步端口冲突是固有限制所有 worktree 共用相同端口同一时间只能hogli start一个实例切换时先用 CtrlC 停掉当前实例。phw pr依赖gh和jq--dir参数可为phw create指定不同于分支名的目录名。phw create会在创建前清理同名残留目录它先执行git worktree prune仅当 Git 不认为该目录仍是活跃 worktree 时才删除残留目录安全逻辑见 bin/posthog-worktree 中的cleanup_stale_worktree。环境层面的问题hogli start连接错误、端口占用、数据库迁移等按 developing-locally.md 的 Common gotchas 一节排查本文不重复。【免费下载链接】posthog:hedgehog: PostHog is the leading platform for building self-driving products. Our developer tools – AI observability, analytics, session replay, flags, experiments, error tracking, logs, and more – capture all the context agents need to diagnose problems, uncover opportunities, and ship fixes. Steer it all from Slack, web, desktop, or the MCP.项目地址: https://gitcode.com/GitHub_Trending/po/posthog创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
` 与 RYB 艺术家色轮色调调整)
