Win11 开发环境安装与配置

张小鱼2026-09-21约 6 分钟

本文整理 Windows 下常用开发工具的安装与配置，方便新机器搭建、系统重装后恢复，也可作为日常配置速查。如果软件有便携版且仅需配置环境变量，则优先选用压缩包；否则使用安装版。

FFmpeg

FFmpeg 是音视频处理工具，可用于格式转换、压缩、提取音轨、截取片段等。

下载最新版的 ffmpeg-release-full.7z，并解压至 D:\Portable\FFmpeg。

打开系统属性（Win+R → sysdm.cpl），点击 高级>环境变量，在 系统变量 中选择 Path，添加 D:\Portable\FFmpeg\bin，以便系统在任意目录下都能识别并运行 ffmpeg 命令。

打开终端（Win+R → cmd），运行以下命令，验证安装：

Bash
1
2
ffmpeg -version
ffprobe -version

Git

Git 是分布式版本控制系统，用于管理博客源码与版本历史。

安装后，桌面右键点击 Open Git Bash Here，运行以下命令，配置用户信息：

Bash
1
2
git config --global user.name "你的用户名"
git config --global user.email "你的邮箱地址"

GitHub CLI

下载 GitHub CLI 压缩包并解压至 D:\GitHub CLI，如 GitHub CLI 2.100.0 windows amd64.zip。

打开系统属性（Win+R → sysdm.cpl），点击 高级>环境变量，在 系统变量 中选择 Path，添加 D:\GitHub CLI\bin，使系统在任意目录下都能识别并运行 gh 命令。

打开终端（Win+R → cmd），运行 gh --version，确认输出包含版本号，以验证安装是否成功。

运行以下命令，进行登录与 SSH 认证：

Bash
1
gh auth login

按提示依次选择（如果之前已配置过 SSH 密钥，第 3-6 步会自动跳过）：

GitHub.com。
SSH。
询问是否生成新的 SSH 密钥时，选择 Yes。
设置密钥密码短语（可直接按 Enter 跳过）。
询问是否上传公钥到 GitHub 账户时，选择 Yes。
输入密钥标题（可回车使用默认值）。
选择 Login with a web browser。
终端显示一次性验证码，按 Enter 打开浏览器，登录 GitHub 并输入验证码。

运行以下命令，测试 SSH 连接是否成功：

Bash
1
ssh -T git@github.com

如果输出包含 You've successfully authenticated 等提示信息，说明 SSH 配置成功。

Go

Go 是 Hugo Module 依赖的编程语言，用于管理 Hugo 主题依赖。

下载 ZIP 压缩包并解压至 D:\Portable\Go，如 go1.27.1.windows-amd64.zip。

打开系统属性（Win+R → sysdm.cpl），点击 高级>环境变量，在 系统变量 中选择 Path，添加 D:\Portable\Go\bin，以便系统在任意目录下都能识别并运行 Go 命令。

打开终端（Win+R → cmd），运行 go version，确认输出包含版本号，以验证是否安装成功。

Hugo

Hugo 是基于 Go 语言的静态网站生成器，能够将 Markdown 转换为 HTML。

下载 Hugo Extended（≥0.156.0）以支持 SCSS 编译，并解压至 D:\Portable\Hugo。

打开系统属性（Win+R → sysdm.cpl），点击 高级>环境变量，在 系统变量 中选择 Path，添加 D:\Portable\Hugo，以便系统在任意目录下都能识别并运行 Hugo 命令。

打开终端（Win+R → cmd），运行 hugo version，确认输出包含版本号，以验证是否安装成功。

Node.js

Node.js 是 JavaScript 运行时，用于运行 npm 脚本和前端构建工具。

下载 ZIP 压缩包（Latest Release）并解压至 D:\Portable\Node.js。

打开系统属性（Win+R → sysdm.cpl），点击 高级>环境变量，在 系统变量 中选择 Path，添加 D:\Portable\Node.js，以便系统在任意目录下都能识别并运行 node 和 npm 命令。

打开终端（Win+R → cmd），运行以下命令，验证安装：

Bash
1
2
node -v
npm -v

运行以下命令，配置 npm 镜像，加速依赖下载（可选）：

Bash
1
2
3
4
5
# 使用淘宝镜像
npm config set registry https://registry.npmmirror.com

# 恢复官方源
npm config set registry https://registry.npmjs.org

Python

Python 是通用编程语言，常用于写脚本处理数据，比如把 CSV 转成 JSON、批量重命名文件等。

下载安装包，安装时务必勾选 Add Python to PATH，否则终端里无法直接运行 python 命令。

打开终端（Win+R → cmd），运行以下命令，验证安装：

Bash
1
2
python --version
pip --version

运行以下命令，配置 pip 镜像，加速依赖下载（可选）：

Bash
1
2
3
4
5
# 使用清华源下载
pip config set global.index-url https://pypi.tuna.tsinghua.edu.cn/simple

# 恢复官方源
pip config unset global.index-url

不同项目常依赖不同版本的库，全局安装容易冲突。虚拟环境 为每个项目提供独立的运行空间，配合 requirements.txt 锁定版本。运行以下命令，创建虚拟环境，激活后终端提示符前会出现 (.venv)：

Bash
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
# 创建
python -m venv .venv

# 激活（按终端选择）
source .venv/Scripts/activate        # Git Bash
.venv\Scripts\Activate.ps1           # PowerShell
.venv\Scripts\activate.bat           # CMD

# 退出
deactivate

进入虚拟环境后，用 pip 管理依赖：

Bash
1
2
3
4
5
6
7
8
pip install requests                    # 安装单个包
pip install requests beautifulsoup4     # 安装多个包
pip install requests==2.28.0            # 安装指定版本
pip install -r requirements.txt         # 从文件安装
pip freeze > requirements.txt           # 导出当前环境依赖
pip list                                # 查看已安装的包
pip install --upgrade requests          # 升级单个包
pip uninstall requests                  # 卸载单个包

requirements.txt 用于记录项目的依赖清单，每行一个包及版本号（如 requests==2.28.0）。换电脑或重新部署时，用它一键还原环境，不必手动逐个安装。

运行以下命令，执行 Python 脚本：

Bash
1
2
3
4
python your_script.py                            # 当前目录
python scripts/your_script.py                    # 子目录
python scripts/your_script.py input.csv          # 传入文件
python scripts/your_script.py input.csv --merge  # 传入文件和选项

不再需要虚拟环境时，删除 .venv 目录即可：

Bash
1
rm -rf .venv

需要时重新运行 python -m venv .venv 创建。

VS Code

‌VS Code 是代码编辑器，支持 Markdown 预览、Git 集成和 Hugo 模板高亮，可用 GitHub 账号同步设置、扩展、快捷键和代码片段，换设备时无需手动重配。安装时在 选择附加任务 页面勾选所有选项，方便通过右键菜单快速打开项目。

进入软件，打开菜单栏的终端（Ctrl+`），点击终端窗口右上角 + 下拉菜单，选择 Git Bash，即可在 VS Code 使用 Bash 终端；打开左侧的扩展（Ctrl+Shift+X），安装 Chinese (Simplified) Language Pack，即可配置中文界面。以下按用途分类推荐扩展，可按需安装：

如果表格源码在编辑器里因自动换行显示混乱，可按 Alt+Z 关闭自动换行，便于查看完整行。

扩展名称	说明
CSV to Markdown Table (and back)	右键 CSV/TSV ↔ Markdown 表格转换
dir tree generator	右键生成文件夹目录树，支持复制为文本
Markdown All in One	编辑增强，`Ctrl+B` 加粗、`Ctrl+I` 斜体
Markdown Document Toolset	右键表格对齐、TSV 复制粘贴、表格和列表互转等
Markdown Table	`Tab` 移至下一单元格，`Shift+Tab` 移至上一单元格最后一格按 `Tab` 自动新增行；右键行列增删、对齐调整
PicList	配合 PicList 上传图片，支持 `Ctrl+Alt+U` 剪贴板、右键、拖拽上传设置 `Copy Style` 选 `custom`，自定义链接格式（`Custom Style`）如 `![$fileName](../../../assets/images/$fileName)`

扩展名称	说明
Even Better TOML	`hugo.toml` 配置文件语法高亮和校验
Git Graph	Git 提交历史和分支关系的图形化展示
Hugo Language and Syntax Support	Hugo 模板语法（Go Template）高亮
Hugo Shortcode Syntax Highlighting	Hugo Shortcode 语法高亮
Prettier - Code formatter	多格式代码格式化，可用 `.prettierignore` 排除无需格式化的文件
Python	脚本编写与运行，配合 Python 使用

扩展名称	说明
Chinese (Simplified) Language Pack	安装后 VS Code 界面显示为简体中文
Comment Translate	选中英文注释或字符串，右键翻译为中文；支持配置翻译引擎
GitHub Theme	GitHub 官方风格亮色 / 暗色主题
Office Viewer	在 VS Code 标签页内直接预览 Office 文档
Open in External App	右键文件用系统默认程序打开
vscode-icons	为文件类型和文件夹显示专属图标

点击扩展右下角的齿轮图标打开设置，用户配置全局生效，工作区配置（位于项目根目录的 .vscode/settings.json）仅对当前项目生效。示例如下：

search.useParentIgnoreFiles：搜索时只读取项目自己的 .gitignore。
search.useGlobalIgnoreFiles：不使用全局 .gitignore。
python.terminal.activateEnvironment：关闭 Python 扩展自动激活虚拟环境。
css.validate：关闭 CSS 校验。