从Mac环境迁移到Windows环境的WooCoo开发指南

发表时间: 2024-03-14 11:40

在上一篇文章中准备完善woocoo「链接」,那在主力机器由Mac转向Windows时,涉及到开发习惯上的切换,因此本文说一下golang在Mac与Windows的不同开发体会。

woocoo之前一直是在Mac上开发,同时github的workflow的CI工作流的构建也是以unbantu在单元测试环境,因此在昨天把woocoo pull下来后,主模块执行单元测试后,发现少量与配置模块有关(conf)的失败了,为了运行全部模块的单元测试,就有了golang整体环境的回顾。

Unix like与Windows代码上的差异

golang是跨平台编译已经做得非常好了,比如老生常谈的路径差异问题其实filepath处理得很好了

Unix: /path/file.ext

Windows: C:\path\file.ext

  • 使用url.Parse在转换文件URI时需要注意,虽然该方式并不推荐,但实践中还是挺常用该包处理的:
Unix:         file:///etc/fstab -> /etc/fstabWindows: file:///c:/WINDOWS/clock.avi  -> /c:/WINDOWS/clock.avi

在Windows上得到的路径无疑会出现问题,包括filepath.Abs等识别都会出现false的问题,不能直接处理,省事点就是使用runtime.GOOS来判断。

开发环境搭建

  • 系统包工具:Mac: homebrew; windows:chocolate 类似,很平滑的切换过来。但一般该类工具我习惯安装一些工具类的软件,像以前的绿色软件之类随处乱丢,使用这类的好管理很多。
  • VI:Windows没有自带,但有对应notepad命令行,只是需要习惯是独立窗口打开
  • Docker:Desktop没有差别,直接安装,但windows一定推荐结合WSL2,这里请大家特别去了解WSL,这点在windows上的开发是优势,而在mac上,没有方法可以模拟windows环境。Docker在Mac上性能很糟糕的,因此一些开发工具都习惯使用homebrew安装的,像测试需要的环境,都是做sh脚本快速启动,但在windows上,这次准备直接使用docker,为了方便woocoo在windows下的测试,在test目录下增加docker compose来方便大家快速测试。
  • IDE:我主力使用goland,也是跨平台的。那就是注意一下快捷键的差异,真希望windwos在系统层面上支持键盘映射,Ctrl键按得很别扭呀。vscode暂时在windwos上没有深度体验,但不管是怎样和goland没得比,这里建议大家做点开源应用向Jetbrains申请开发者证书。
  • CLI:powershell的强大没得说,特别是多Tab功能,想吐槽的就是命令错误提示了,多一堆没用的栈。

这样在打通了这些差异后,基本上在windows的开发环境基本也就算完成迁移了,那我会根据后续的开发进展,慢慢补充。

另外,需要注意的是两个不平台上的测试,分别跑,倒是出现奇怪的结果:

Mac: intel 9代: 6核32G

Windows:intel 14代I7 :8个P-core(性能核)和12个E-core(能效核)64G

go test -benchmem -run=^$ -bench ^BenchmarkGinDefault$ .

Mac: 59079 , 20768 ns/op , 403 B/op , 14 allocs/op

Windows: 37585 , 32986 ns/op , 620 B/op , 15 allocs/op

go test -benchmem -run=^$ -bench ^BenchmarkWooCooWebDefault$ .

Mac: 591321 , 1870 ns/op , 1196 B/op , 7 allocs/op

Windows: 1319931 , 940.2 ns/op , 1269 B/op , 7 allocs/op

go test -benchmem -run=^$ -bench ^BenchmarkGinDefaultMockLogger$ .

Mac: 729430 , 1438 ns/op , 317 B/op , 10 allocs/op

Windows: 1760342 , 688.8 ns/op , 314 B/op , 10 allocs/op

诧异表现就是 Gin 默认初始化结果在不同平台下与机器性能差异负相关了,应该是stdout的问题,而采用Gin内存日志与Woocoo采用Zap日志的表现就跟机器性能出现的误差就正常了。请有做过该项目研究的同学不领赐教。

常用命令行工具

查询端口占用: lsof -i tcp 80 --> netstat -ano | find ":80" , 获取到PID后,再任务管理器查哪个程序