Windows 环境下搭建 RedwoodJS 开发环境的完整指南：Git Bash + nvm-windows + Yarn-平芜编程栈

后端
前端
Web框架
开发工具

【免费下载链接】redwood

RedwoodGraphQL

项目地址：https://gitcode.com/gh_mirrors/re/redwood

本指南基于 RedwoodJS 官方文档 Windows Development Setup 编写，目标是在 Windows 上以最简单、最稳妥的方式搭建一套可用于开发 RedwoodJS 全栈应用的本地环境：安装 Git for Windows（Git Bash）、通过 nvm-windows 管理 Node.js 与 npm、再安装 Yarn 包管理器。读完本文，你将拥有一个可直接运行yarn create redwood-app myApp并启动开发服务器的完整环境，同时理解每个组件在 Redwood 开发链路中的作用、版本要求与常见坑位。

为什么选择这套组合

Windows 上搭建 JavaScript 全栈开发环境的方式有很多（PowerShell、CMD、WSL 等），Redwood 官方推荐以Git Bash作为默认终端。理由很直接：

Git Bash 提供类 Unix 的 shell 体验，与 Redwood 文档、教程中大量基于 bash 的命令示例完全兼容，复制粘贴即可运行；
nvm-windows 让 Node.js 多版本共存成为可能，Redwood 对 Node 版本有明确要求，切换项目时可以随时nvm use到对应版本；
Yarn 是 Redwood 的包管理器与命令入口，项目内几乎所有操作（创建、开发、测试、构建）都经由yarn驱动。

官方明确指出，除非你已有 PowerShell 等其他 shell 的熟练经验，否则这套组合就是推荐路径。若你更倾向于 Windows Subsystem for Linux（WSL），社区也有专门的安装指南可供参考（见社区讨论帖）。

第一步：安装 Git for Windows，获得 Git Bash

从Git for Windows 官网下载最新版本的安装包并运行安装。安装过程中有两个可选但值得勾选的选项：

在桌面创建 Git 图标（方便之后右键打开 Git Bash）；
如果你使用 Windows Terminal，可将 Git Bash 配置文件加入其中，之后即可从 Windows Terminal 直接启动。

随后需要设置 Git 的默认编辑器：官方推荐将VS Code设为 Git 的默认编辑器（也可以选择你习惯的其他编辑器），后续git commit触发编辑器时体验更顺手。除此之外，其余安装步骤全部保持默认选择即可，无需额外定制。

安装完成后，任意目录下右键选择Git Bash Here即可打开终端。注意：后续所有命令都应在 Git Bash 中执行。

第二步：安装 nvm-windows 管理 Node.js

Redwood 依赖的 Node 版本会随框架演进而调整，因此推荐使用版本管理器而不是直接安装单个 Node 安装包。Windows 上对应的工具是nvm-windows（注意它与 macOS/Linux 上的 nvm 是两个独立项目，Windows 请务必使用 nvm-windows）。

安装步骤：

在 nvm-windows 的 Releases 页面下载最新的nvm-setup.zip；
解压后运行其中的nvm-setup.exe，按向导提示完成安装；
安装完成后，以管理员身份运行 Git Bash（右键 Git Bash 图标 → "以管理员身份运行"），后续通过 nvm 安装 Node 均需要管理员权限。

如果你此前已经单独安装过 Node.js，建议先卸载再安装 nvm-windows，避免版本管理冲突。更完整的 nvm 使用说明可参考使用 nvm 管理 Node.js 版本。

验证安装

在管理员 Git Bash 中执行：

nvm --version

输出 nvm-windows 的版本号即表示安装成功。

第三步：安装 Redwood 所需的 Node.js LTS 版本

Redwood 使用Node.js 的 LTS（长期支持）版本。在原文档所对应的 Redwood 1.x 时期，推荐的安装命令与示例如下：

# 安装最新的 LTS 版本并附带最新版 npm（例如当时的 16.13.1） nvm install lts --latest-npm # 切换到刚安装的版本 nvm use 16.13.1

--latest-npm参数会让 nvm 同时安装与当前 Node 匹配的最新版 npm，避免后续npm install -g yarn时出现版本过旧的问题。安装多个版本后，可用nvm ls查看已安装版本、用nvm alias default <版本号>设定默认版本。

版本要求是会演进的：以脚手架校验为准

需要注意，不同时期的 Redwood 对 Node 版本的要求不同。以本仓库当前主分支文档教程前置要求为例，其记录的校验条件是：

node：=20.x
yarn：>=1.22.21

版本要求实际由脚手架强制校验，而非仅仅写在文档里。从 create-redwood-app 入口源码可以看到，创建项目时会调用check-node-version对 node 与 yarn 做兼容性检查，若版本不满足（过高或过低），脚手架会直接中断并提示你升级或降级（对应源码中的You need to upgrade the version of node you're using.与You may want to downgrade the version of node you're using.分支逻辑）。因此最稳妥的做法是：以当前版本 Redwood 的实际要求为准，安装后先用以下命令核对：

node --version npm --version

第四步：安装 Yarn

Node 与 npm 就绪后，就可以通过 npm 全局安装 Redwood 的包管理器 Yarn：

npm install -g yarn

执行完毕后可用yarn --version验证。至此，node、npm、yarn三个命令都已在 PATH 中可用。

补充：Corepack 是更现代的替代方案

Node.js 16.10 起官方内置了Corepack工具，用于管理各包管理器版本，这也是当前 Redwood 项目实际采用的机制。本仓库根目录 package.json 中声明了"packageManager": "yarn@4.6.0"，Redwood 项目正是通过该字段让 Corepack 自动使用匹配的 Yarn 版本。若想启用 Corepack，只需执行：

corepack enable

之后在包含packageManager字段的项目目录内运行yarn，Corepack 会自动切换到对应版本，无需手动全局安装。两种方式任选其一即可，关于 Yarn 的更深入用法可参考使用 Yarn。

环境就绪：创建你的第一个 Redwood 项目

完成上述三步后，环境已完全就绪。在 Git Bash 中运行：

yarn create redwood-app myApp

稍等片刻，脚手架会在当前目录下生成myApp项目骨架。随后进入项目目录并启动开发服务器：

cd myApp yarn redwood dev

浏览器会自动打开http://localhost:8910（端口号 8-9-10 很好记），看到 Redwood 欢迎页即代表开发环境完全打通。更完整的创建与开发流程可参考教程章节安装与启动开发。

踩坑提示与故障排查

警惕 Windows 的大小写不敏感

Windows 文件系统不区分大小写，这会在 Git Bash 中造成一种"看起来一样"的假象：cd myapp与cd myApp会进入同一个目录。但 Redwood 项目内部对文件名、路径的大小写是有约定的（例如组件、页面、服务等文件的命名），请始终按创建时的原始大小写输入路径，否则可能引发难以定位的引用错误。

缺少 Microsoft Visual C++ Redistributable

如果你的 Windows 机器从未安装过Microsoft Visual C++ Redistributable，部分依赖的原生模块在编译或运行时可能报错。遇到此类情况时，从微软官方页面下载并安装 Visual Studio 2015–2022 对应的最新版 VC++ Redistributable 即可（在微软 Learn 文档的 "Latest supported Visual C++ Redistributable downloads" 一节中获取 x64 版本）。该问题在全新安装、从未装过编译运行时的 Windows 环境中出现概率较高，可提前安装以绝后患。

安装前先卸载旧版 Node

若机器上已有独立安装的 Node.js，务必先通过"设置 → 应用"中卸载 Node.js（官方建议卸载后重启一次），再安装 nvm-windows。否则两个 Node 可能互相干扰，导致nvm use失效或 PATH 混乱。

小结

这套 Windows 开发环境由三个层次构成：Git Bash 提供类 Unix 终端、nvm-windows 提供 Node 版本管理、npm/Yarn 提供包管理与 Redwood CLI 入口。它们共同支撑起 Redwood 项目的创建、开发、测试与构建全流程。搭建完成后，下一步就是进入 Redwood 官方教程，开始你的全栈开发之旅。