macOS与Windows安装templ遇‘templ not found’问题及疑问

核心原因是Go的二进制输出目录未被加入系统PATH环境变量，具体分系统来看：

macOS 情况 #

默认情况下，Go会把go install编译出的二进制文件放到$HOME/go/bin（如果没手动设置GOPATH）。但多数zsh/bash的默认配置里，这个目录并没有被添加到系统PATH中，所以终端无法找到templ命令。你通过添加别名直接指定二进制文件的绝对路径，相当于绕开了PATH的查找逻辑，自然能正常使用。

Windows 情况 #

Windows下Go的默认输出目录是%USERPROFILE%\go\bin（比如C:\Users\你的用户名\go\bin），同样这个目录大概率不在系统PATH里，导致CMD或PowerShell识别不到templ。你把下载的二进制放到Go安装目录的bin文件夹（C:\Program Files\Go\bin），是因为Go安装时通常会自动把这个目录加入PATH，所以终端能找到命令。

源码克隆后go install仍报错的原因 #

不管是直接go install远程包，还是克隆源码后执行go install，最终都是把二进制文件放到$GOPATH/bin目录。只要这个目录不在系统PATH里，终端就找不到templ，和安装方式无关。

更规范的解决方式（推荐） #

• macOS/Linux：在~/.zshrc（或~/.bashrc）中添加一行：export PATH="$PATH:$HOME/go/bin"，执行source ~/.zshrc（对应你的shell配置文件）让配置生效。
• Windows：打开系统环境变量设置，找到PATH变量，添加%USERPROFILE%\go\bin路径，重启终端后即可生效。

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