Golang构建基于目录监听的静态资源自动化编译-Golang-PHP中文网

fsnotify监听目录时漏掉新建文件，是因为其默认不递归监听，仅响应显式add的目录事件；新建子目录需在收到create事件后经os.stat确认为目录再调用watcher.add()动态添加，且路径不可带尾斜杠。

golang构建基于目录监听的静态资源自动化编译

默认监听模式下，fsnotify.Watcher 只监听已存在的目录，不会自动递归监听子目录里后续创建的子目录或文件。比如你监听 "./src"，但 "./src/js" 是编译过程中新建的，它就不会被纳入监听范围。

必须在初始化时对目标目录及其所有子目录手动调用 watcher.Add()，不能只加顶层路径
推荐用 filepath.WalkDir 遍历初始目录树，逐个 Add —— 注意跳过符号链接，避免循环或权限错误
监听后收到 fsnotify.Create 事件时，如果是目录，要立刻再调用 watcher.Add()，否则该目录下的后续变更（如新文件写入）会被忽略
Windows 下对长路径或某些编辑器（如 VS Code）的临时文件写入行为敏感，建议过滤掉以 . 或 ~ 开头、或含 .tmp/.swp 后缀的事件

多个文件连续修改（比如保存一个 TypeScript 文件，触发 .ts → .js → .min.js 链式生成）可能在极短时间内发出多个 Write 事件，若每个都直接执行 go build 或 esbuild，会导致输出文件被覆盖、中间态冲突，甚至进程卡死。

用 time.AfterFunc 实现简单防抖：收到首个事件后启动 100ms 计时器，期间新事件仅重置计时器，超时后才执行编译
不要用 sync.Mutex 粗暴阻塞事件通道 —— 这会让后续事件堆积，延迟感知
编译命令建议加上 -o 明确输出路径，并确保输出目录存在（os.MkdirAll），避免因路径不存在导致静默失败
如果编译依赖外部工具（如 tailwindcss），检查其是否支持 stdin/stdout 流式处理；不支持的尽量走临时文件 + 原子重命名（os.Rename）

常见原因是监听编译输出目录（如 ./dist）后，直接把 http.FileServer 指向该目录，但没处理路径映射和索引逻辑 —— 浏览器请求 / 时，FileServer 默认找 index.html，而你可能生成的是 index.htm 或根本没生成。

初始化并管理阿里云SDK Go 客户端，涵盖 sync.Once 单例、goroutine 安全、endpoint 与 region 配置、VPC 端点及调试。

下载

用 http.StripPrefix 剥离 URL 前缀后再交给 FileServer，例如 http.Handle("/static/", http.StripPrefix("/static/", http.FileServer(http.Dir("./dist"))))
若需 SPA 路由（如 React/Vue），得自己写一个 fallback handler：当 FileServer 返回 404 且路径不含 .（即非静态资源），就返回 ./dist/index.html
开发中建议开启 http.ServeFile 的 debug 日志（包装一层 handler 打印请求路径），确认实际访问路径与文件系统路径是否对齐
注意 FileServer 不会自动解压 .gz 文件，若你做了 gzip 预编译，得额外实现 Content-Encoding 判断逻辑

后台常驻的监听服务一旦启动，Ctrl+C 默认只终止主 goroutine，子进程（如 exec.Command("esbuild")）可能还在跑，残留进程占端口或锁文件。

用 context.WithCancel 创建上下文，在 os.Interrupt 信号到来时调用 cancel()，并在所有子命令启动时传入该 context
编译命令优先用 exec.CommandContext 替代 exec.Command，这样 cancel 会自动 kill 子进程
日志建议用 log.Printf 而非 fmt.Println，并带上时间戳和事件类型（"[watch] create ./src/main.ts"），方便定位是监听问题还是编译逻辑问题
临时文件（如 .cache 或 node_modules/.bin）建议排除监听，它们变动频繁且与业务无关，纯属噪音