工具各自做什么#
Go 负责编译和运行后端;Node.js 运行前端开发工具;npm 下载前端依赖;浏览器显示页面;PowerShell 把你的命令交给这些工具。编辑器负责编辑源码,本项目不要求特定品牌。SQLite 驱动是 Go 依赖,不用先安装独立 SQLite 服务器。
按 Windows 键搜索 PowerShell,打开普通终端。在终端输入:
Set-Location -LiteralPath 'D:\xiaolanshu-go' Get-Location Get-ChildItem |
第一条进入项目根目录,第二条应显示 D:\xiaolanshu-go,第三条应看到 cmd、frontend、internal、docs。-LiteralPath 把路径按原样处理,带中文和空格的路径也要放进引号。目录位置不对是最常见的入门错误。
检查软件#
go version node --version npm.cmd --version |
每条都会输出版本。如果提示“不识别为命令”,说明软件未安装或当前终端还没获得新 PATH。先安装官方 Go 和 Node.js 24 LTS,再关闭并重新打开终端。Go 1.24.2 能读取项目的工具链声明并下载 Go 1.26.11,第一次运行需要网络。
Windows 上使用 npm.cmd 能避免 npm.ps1 被执行策略拦住。这是调用方式调整,不需要永久放宽系统执行策略。后面脚本中的 -ExecutionPolicy Bypass 只作用于那次 PowerShell 子进程。
什么叫当前目录#
frontend 是相对路径,会根据你站在哪里改变含义;D:\xiaolanshu-go\frontend 是绝对路径。教程默认站在项目根目录,所以命令写成 npm.cmd ci --prefix frontend。不要先进入 frontend 再复制这条带 --prefix frontend 的命令,否则它会寻找另一层 frontend。
. 指当前目录,.. 指上一级。go test ./... 里的 ./... 表示当前模块下面所有包,不是文件夹名称。Ctrl+C 用来停止前台程序;终端看起来一直不返回提示符,有可能是服务器正在正常监听。
安全练习#
运行 Get-Content -Encoding utf8 README.md -TotalCount 20 阅读前 20 行。这个命令只读。再打开 .env.example,观察每行 名字=值,先不要填写真实密码。点号开头的文件在某些界面里不明显,但仍是普通文件。
验收:你能独立进入正确目录,确认三个版本,知道成功运行服务后为什么要保留终端。遇到红色错误先读第一条错误,不要同时重装所有工具。