01 · Install from source

从一个干净目录安装

走完 git clone、依赖安装、质量检查、构建、npm link 和 PATH 验证。没有隐藏的一键脚本。

准备 Git、Node.js 和终端

推荐 Node.js 20 或 22。Windows 可使用 PowerShell，macOS/Linux 使用系统终端。先分别运行 git --version、node --version 和 npm --version；命令不存在时先安装对应程序并重新打开终端。

检查工具链

git --version
node --version
npm --version

git version 2.x
v20.x 或 v22.x
10.x 或更高

版本号会因系统而不同。关键是三个命令都成功，并且 Node 满足项目的 engines 约束。

取得公开源码

git clone https://gitee.com/Woohe/tyndall-blog-cli.git
cd tyndall-blog-cli
git status
git remote -v

clone 下载仓库与历史；cd 切换当前目录；status 确认工作区；remote -v 让远端来源可见。

完整安装链路

npm install
npm run typecheck
npm test
npm run build
npm link
blog --version
blog --help

npm install 按锁文件解析依赖；后三个 npm scripts 分别验证类型、行为和构建产物；npm link 把当前源码仓库暴露为全局命令。

如果 blog 找不到，运行 npm prefix -g 查看当前 Node 环境的全局前缀，并检查对应可执行文件目录是否在 PATH。使用 nvm、fnm 等切换 Node 版本后，全局链接属于另一个 Node 环境，通常需要重新 npm link。