# 02｜电脑、终端与文件：先让命令跑在正确的位置

前一站：[项目导览](01-project-tour.md) · 下一站：[Web 基础](03-web-basics.md)

## 工具各自做什么

Go 负责编译和运行后端；Node.js 运行前端开发工具；npm 下载前端依赖；浏览器显示页面；PowerShell 把你的命令交给这些工具。编辑器负责编辑源码，本项目不要求特定品牌。SQLite 驱动是 Go 依赖，不用先安装独立 SQLite 服务器。

按 Windows 键搜索 PowerShell，打开普通终端。在终端输入：

```powershell
Set-Location -LiteralPath 'D:\xiaolanshu-go'
Get-Location
Get-ChildItem
```

第一条进入项目根目录，第二条应显示 `D:\xiaolanshu-go`，第三条应看到 `cmd`、`frontend`、`internal`、`docs`。`-LiteralPath` 把路径按原样处理，带中文和空格的路径也要放进引号。目录位置不对是最常见的入门错误。

## 检查软件

```powershell
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`，观察每行 `名字=值`，先不要填写真实密码。点号开头的文件在某些界面里不明显，但仍是普通文件。

验收：你能独立进入正确目录，确认三个版本，知道成功运行服务后为什么要保留终端。遇到红色错误先读第一条错误，不要同时重装所有工具。
