环境预装 · Z

脚本会安装软件、写 Git 配置、生成 SSH 密钥。已装的跳过，已有的配置不覆盖。运行前先读一遍脚本内容。

01 · WINDOWS

Windows

1用 winget 装齐软件

打开 PowerShell，整段粘贴，回车。已装的会提示并跳过。个别安装器会弹 UAC，点是。

POWERSHELL

winget install -e --id Python.Python.3.12 --accept-package-agreements --accept-source-agreements
winget install -e --id OpenJS.NodeJS.LTS --accept-package-agreements --accept-source-agreements
winget install -e --id Git.Git --accept-package-agreements --accept-source-agreements
winget install -e --id Gyan.FFmpeg --accept-package-agreements --accept-source-agreements
winget install -e --id Microsoft.VisualStudioCode --accept-package-agreements --accept-source-agreements
winget install -e --id 7zip.7zip --accept-package-agreements --accept-source-agreements
winget install -e --id Microsoft.PowerToys --accept-package-agreements --accept-source-agreements
winget install -e --id Microsoft.WindowsTerminal --accept-package-agreements --accept-source-agreements

2一条命令跑完整脚本

从网络取脚本直接执行，等同于下载第 3 步的 win-setup.ps1 再运行。先读完下面的脚本再跑。脚本开头会停一下等你按回车。

POWERSHELL

irm https://z.cohenjikan.com/setup/win-setup.ps1 | iex

3脚本 win-setup.ps1

下载脚本

只对当前进程放开执行策略，不改系统设置。winget 装软件，Git 用户名与邮箱按提示输入，没有 SSH 密钥就生成一把 ed25519，再装 pip 包与 pnpm。可重复运行。

WIN-SETUP.PS1

加载中

02 · MAC

Mac

1装 Homebrew

在「终端」里运行。装完按它的提示把 brew 加进 PATH，Apple Silicon 通常是 eval "$(/opt/homebrew/bin/brew shellenv)"。

TERMINAL

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

2按 Brewfile 装软件

下载 Brewfile

先把 Brewfile 放到家目录，再让 brew 按清单安装。已装的会跳过。

TERMINAL

curl -fsSL https://z.cohenjikan.com/setup/Brewfile -o ~/Brewfile
brew bundle --file=~/Brewfile

BREWFILE

加载中

3Python 包与 pnpm

Homebrew 的 Python 默认拒绝全局 pip 安装，所以带 --break-system-packages。想隔离就先 python3.12 -m venv ~/.venv，激活后去掉这个参数。

TERMINAL

python3.12 -m pip install -U --break-system-packages pip yt-dlp pymupdf pillow python-docx fastapi uvicorn
npm i -g pnpm

03 · 清单

装了什么，为什么

工具	用途
Python 3.12WIN · MAC	脚本与 pip 工具，和本站后端同一个版本。
Node.js LTSWIN · MAC	前端工具链，npm 与 pnpm 的运行时。
GitWIN · MAC	版本管理，拉取与提交仓库。
FFmpegWIN · MAC	音视频转码与合并，yt-dlp 需要它。
yt-dlpWIN · MAC	下载视频与音频。
VS CodeWIN · MAC	编辑器。
7-ZipWIN	解压各种格式。
PowerToysWIN	窗口布局、取色、批量重命名。
Windows TerminalWIN	顺手的终端，多标签。
iTerm2MAC	终端，比自带的好用。
RectangleMAC	快捷键分屏。
pymupdf · pillow · python-docxPIP	处理 PDF、图片、Word。
fastapi · uvicornPIP	本站后端框架，本地也能跑接口。
pnpmNPM	更快更省盘的包管理器。