Windows 前端开发入职环境配置

拿到一台新的 Windows 开发电脑后，先把版本控制、Node.js 和常用命令行工具配置好，再开始拉取项目。这样能把权限、环境变量和版本问题集中在第一天解决，避免在项目启动后交叉排查。

准备工作

开始前确认已经具备：

• 一个工作邮箱，以及对应的 GitHub 或 GitLab 账号访问权限
• 可以安装软件的 Windows 电脑
• 规定的 Node.js 版本和 AI 工具使用策略

安装 Git 并配置身份

从 Git for Windows 官方下载页 安装 Git。安装完成后重新打开 PowerShell，先确认命令可用：

git --version

然后设置提交记录中显示的名称和邮箱。工作项目应使用公司允许的身份信息：

git config --global user.name "你的名字或昵称"
git config --global user.email "你的工作邮箱"

用下面的命令检查配置来源和最终结果：

git config --global --list --show-origin

配置 SSH 密钥

SSH 密钥用于让本机安全访问 Git 远程仓库。先检查是否已有密钥目录；没有输出也可能只是尚未生成过密钥：

Get-ChildItem -Force "$HOME\.ssh" -ErrorAction SilentlyContinue

新建密钥时优先使用 ed25519。命令执行后，除非公司有统一路径要求，否则可以接受默认保存位置；为私钥设置密码短语可以降低设备遗失时的风险。

ssh-keygen -t ed25519 -C "你的工作邮箱"

复制公钥内容时，只读取以 .pub 结尾的文件：

Get-Content "$HOME\.ssh\id_ed25519.pub"

不要复制、上传或发送 id_ed25519 私钥文件。

接下来在托管平台添加公钥：

1. 在 GitHub 的 Settings > SSH and GPG keys 中选择 New SSH key，填入能识别设备的标题并粘贴公钥。可参考 GitHub SSH 文档。
2. 在 GitLab 个人资料的 SSH Key 管理页添加公钥。界面会随版本调整，以 GitLab SSH 文档 为准。

添加完成后，用实际使用的平台测试连接。第一次连接官方域名时会出现主机指纹确认提示，确认域名无误后再继续：

ssh -T git@github.com
# 或
ssh -T git@gitlab.com

使用 nvm-windows 管理 Node.js

Windows 上需要使用独立的 nvm-windows 管理 Node.js 版本；它与 macOS、Linux 上常见的 nvm 不是同一个项目。

安装时为 nvm 和 Node.js 选择不包含空格、中文或特殊字符的目录。安装完成后重新打开 PowerShell，确认 nvm 可用：

nvm version

网络环境允许时，可以在安装 Node.js 前配置镜像：

nvm node_mirror https://npmmirror.com/mirrors/node/

以下示例安装并启用 Node.js 22.12.0。当前小站项目要求 Node.js 22.12.0 或更高版本；其他项目应以各自的 package.json 或团队文档为准。

nvm install 22.12.0
nvm use 22.12.0
node --version
npm --version

如果 nvm use 提示没有权限，通常与 Windows 创建版本切换链接的权限有关。根据公司规范以管理员身份运行终端，或联系 IT 处理，不要通过修改系统目录权限绕过限制。

安装 AI 编程命令行工具

Claude Code 和 Codex 都可能读取当前目录的源码与配置。

Claude Code

按照 Claude Code 官方安装文档 操作。PowerShell 安装命令如下；它会执行官方站点提供的安装脚本，受管设备应先确认这一方式符合公司要求：

irm https://claude.ai/install.ps1 | iex
claude --version

Codex

Codex CLI 可通过官方 npm 包安装。Node.js 环境配置完成后执行：

npm install -g @openai/codex
codex --version

随后运行 codex 并按终端提示完成登录。更多安装和登录方式以 Codex 官方文档 为准。

CC Switch、CodexPlusPlus 等供应商切换或配置管理工具属于第三方工具，不是基础环境的必需项。

最后检查

完成配置后，依次执行以下命令。每一项都能正常返回版本号，说明基础命令与 PATH 已生效：

git --version
node --version
npm --version
claude --version
codex --version

如果出现“找不到命令”，先关闭并重新打开终端，再检查安装程序是否已写入 PATH。若 SSH 测试报 Permission denied (publickey)，确认仓库远程地址使用 SSH、托管平台中保存的是 .pub 公钥，并且私钥仍保存在本机。

环境通过检查后，再根据项目的 README 选择对应的 Node.js 版本、克隆仓库并安装依赖。