1. 为什么要在 Windows 上认真搭一套 AI 编程环境很多人第一次接触 AI 编程注意力全在“用哪个模型”“写什么提示词”上结果环境没搭明白光装个 Node.js 就卡了一下午。我见过太多人卡在node.js v24.21.0 is not yet released or is not available这种报错上也见过有人 VS Code 装完了却不知道插件市场为什么打不开。说实话AI 编程这件事工具链的顺畅程度直接决定了你能不能坚持下去。Windows 作为日常办公和开发的主力平台搭建 AI 编程环境有它自己的脾气。它不像 Linux 那样包管理器一把梭也不像 macOS 那样开箱即用Windows 的路径问题、权限问题、环境变量问题每一个都能让你在“Hello World”之前就耗尽耐心。但反过来说一旦你把 Windows 这套环境搭稳了后面无论是跑本地模型、调云端 API还是用 AI Agent 自动写代码都会顺得不像话。这篇内容面向的是想在 Windows 上从零搭建 AI 编程环境的人。不管你之前有没有编程基础只要你愿意跟着一步步操作就能把 Node.js、VS Code、Git、Docker 这些基础设施装好并且知道每一步为什么要这么做。我会把踩过的坑、验证过的参数、以及那些官方文档不会告诉你的细节都写出来。核心关键词就几个Windows、AI、编程环境、Node.js、VS Code围绕它们展开但不止于它们。2. 环境搭建前的整体规划与选型思路2.1 先想清楚你要用 AI 编程做什么搭环境之前先问自己一个问题你打算用 AI 编程来干什么这个问题决定了你要装什么、不装什么。如果你只是想用 AI 辅助写一些脚本、做数据处理那 Node.js 加 VS Code 加一个 AI 插件就够了。如果你想跑本地大模型那还得考虑 Docker、WSL2、显卡驱动这些东西。如果你想做 AI Agent 开发那 Git、Python、Node.js 三件套一个都不能少。我自己的经验是不要一上来就追求“全都要”。很多人看到网上说 Docker 好用就装 Docker看到 WSL2 方便就开 WSL2结果每个都只装了一半环境变量互相打架最后连node -v都跑不出来。正确的做法是分阶段来第一阶段先把 Node.js 和 VS Code 搞定能跑起来一个 AI 辅助编程的流程第二阶段再根据实际需要补 Git、Docker、Python 这些。2.2 为什么 Node.js 是 AI 编程环境的核心Node.js 在这个环境里扮演的是“胶水”的角色。现在绝大多数 AI 编程工具、CLI 工具、Agent 框架都是用 JavaScript 或 TypeScript 写的跑在 Node.js 运行时上。比如你用的 AI 插件如果需要在本地起一个服务大概率是 Node.js 服务。你想用命令行调用某个 AI 模型的 API很多官方 SDK 也是 Node.js 版本最全。选 Node.js 版本这件事有讲究。网上搜node.js安装会出来一堆教程有的让你装最新版有的让你装 LTS。我的建议是装 LTS 版本不要追最新。原因很简单AI 编程工具链里很多依赖对 Node.js 版本有要求太新的版本反而容易遇到兼容性问题。比如你搜到的node.js 18 the requested module node:util does not provide an export named这个报错就是典型的版本不匹配问题。Node.js 18 和 20 是目前兼容性最好的两个 LTS 版本选其中一个就行。2.3 VS Code 为什么是 AI 编程的首选编辑器VS Code 在 AI 编程领域的地位很大程度上是因为它的插件生态。你搜vs code ai插件 codex、claude code for vs code、vs code gemini cli companion 怎么用这些热词背后都是同一个事实主流 AI 编程工具优先支持 VS Code。它的插件市场里有大量 AI 辅助编程的扩展从代码补全到对话式编程从代码审查到自动生成测试几乎覆盖了 AI 编程的所有场景。VS Code 本身的轻量级设计也很关键。它不像完整的 IDE 那样笨重启动快、占用资源少同时又能通过插件扩展出接近 IDE 的功能。对于 AI 编程来说这意味着你可以在同一个窗口里写代码、和 AI 对话、看 AI 生成的建议不用来回切换工具。下载 VS Code 直接去官网搜vs code官网或者vs code下载都能找到注意选 Windows 版本安装的时候勾选“添加到 PATH”那个选项后面会省很多事。2.4 Git 和 Docker 什么时候需要装Git 不是 AI 编程的必需品但它是版本控制的基础。你用 AI 生成代码之后总得有个地方存吧总得能回滚吧Git 就是干这个的。Windows 上装 Git 有个坑安装程序会问你“Adjusting your PATH environment”怎么选默认选项是“Use Git from Git Bash only”这个选项会导致你在 CMD 或 PowerShell 里用不了 git 命令。一定要选“Git from the command line and also from 3rd-party software”。Docker 则是另一个层级的需求。如果你要跑本地模型、要部署 AI 服务、要用容器化的开发环境那 Docker 迟早要装。但 Docker Desktop for Windows 对系统版本有要求而且和 WSL2 有绑定关系。我的建议是第一阶段先不装 Docker等你确实遇到“这个工具只能用 Docker 跑”的情况再装。搜docker windows和windows安装docker的教程很多但装之前先确认你的 Windows 版本支持 WSL2。3. Node.js 安装的完整实操与避坑指南3.1 下载与安装选对版本比什么都重要Node.js 的安装包去官网下载搜node.js下载或者node.js安装教程都能找到。打开官网之后你会看到两个版本LTS 和 Current。选 LTS。LTS 是长期支持版稳定性和兼容性都有保障。Current 是最新特性版适合尝鲜但不适合作为 AI 编程环境的基础。下载的时候注意选 Windows Installer (.msi) 版本不要选压缩包版本。msi 安装程序会自动帮你配置环境变量省去手动设置的麻烦。安装过程中有几个选项要注意安装路径默认是C:\Program Files\nodejs\建议不要改。改路径有时候会导致一些工具找不到 Node.js。自定义安装安装类型选默认的就行不需要额外勾选什么。Tools for Native Modules这个选项会问你“Automatically install the necessary tools”如果你不需要编译原生模块可以不勾。勾了的话它会额外下载 Visual Studio Build Tools好几个 G没必要。安装完成之后打开一个新的 PowerShell 窗口输入node -v和npm -v。如果能看到版本号说明安装成功。如果提示“不是内部或外部命令”说明环境变量没配好需要手动加。3.2 环境变量配置手动排查的方法正常情况下 msi 安装程序会自动把 Node.js 加到系统 PATH 里。但有时候因为权限问题或者安装过程中的意外PATH 没配上。这时候你需要手动检查右键“此电脑” - 属性 - 高级系统设置 - 环境变量在“系统变量”里找到 Path双击打开看看有没有C:\Program Files\nodejs\这一条如果没有点“新建”加上去然后一路确定加完之后一定要重新打开一个终端窗口环境变量的修改不会自动同步到已经打开的窗口。这个细节很多人不知道改完 PATH 发现还是不行就是因为没重开窗口。3.3 npm 配置换源和全局目录Node.js 装好之后npm 是自带的。但默认的 npm 源在国内访问速度不稳定建议换成国内镜像源。命令很简单npm config set registry https://registry.npmmirror.com换完之后可以用npm config get registry确认一下。这个操作能显著提升后续安装 AI 编程相关 npm 包的速度。另一个建议是设置 npm 的全局安装目录。默认情况下npm install -g装的包会放在用户目录下的 AppData 里路径又长又深。我习惯把它改到一个更短、更好找的路径npm config set prefix C:\nodejs\global npm config set cache C:\nodejs\cache设置完之后记得把C:\nodejs\global也加到系统 PATH 里否则全局安装的命令行工具用不了。3.4 验证安装跑一个真实的 AI 相关包光看版本号还不够最好实际装一个 AI 编程相关的包来验证环境是否正常。比如你可以装一个常用的 AI SDKnpm install -g anthropic-ai/sdk或者装一个 CLI 工具试试。如果安装过程没有报错说明 Node.js 和 npm 的配置都没问题。如果遇到node.js 18 the requested module node:util does not provide an export named这种报错大概率是 Node.js 版本和某个包的依赖不匹配升级或降级 Node.js 版本可以解决。注意不要同时装多个 Node.js 版本而不做版本管理。如果你确实需要切换版本用 nvm-windows 这个工具不要手动改 PATH。4. VS Code 配置与 AI 插件生态实战4.1 安装 VS Code 及中文环境配置VS Code 的安装比 Node.js 简单得多。去官网下载 Windows 版安装包双击运行一路下一步。安装过程中有两个选项建议勾选添加到 PATH勾上之后可以在命令行里用code .直接打开当前目录将“通过 Code 打开”操作添加到目录上下文菜单右键文件夹就能用 VS Code 打开安装完成后第一次启动界面是英文的。搜vs code中文插件可以找到中文语言包在扩展面板里搜索“Chinese”就能找到。安装后重启 VS Code界面就变成中文了。这个操作虽然简单但对于英文不太好的朋友来说能大幅降低上手门槛。4.2 AI 编程插件的选择与安装VS Code 的 AI 编程插件分几类我按使用场景来说代码补全类这类插件在你写代码的时候实时给出建议类似 GitHub Copilot 的体验。搜ai编程相关的插件排名靠前的几个都可以试试。安装方法就是在扩展面板搜索插件名点安装。对话式编程类这类插件提供一个聊天窗口你可以用自然语言描述需求AI 生成代码。搜claude code for vs code或者vs code gemini cli companion 怎么用能找到相关工具。这类插件通常需要配置 API Key安装后在设置里填入你的密钥就行。Agent 类这类插件能自动执行多步任务比如“帮我重构这个文件”“帮我写一套测试”。搜ai agent相关的 VS Code 插件选择下载量高、更新频繁的。安装插件的时候有个常见问题插件市场打不开。这通常是因为网络原因可以尝试在 VS Code 设置里配置代理或者手动下载 vsix 文件离线安装。4.3 用 AI 插件跑通第一个编程流程插件装好之后怎么验证它能不能用我建议用一个最小化的流程来测试新建一个.js文件写一行注释比如// 写一个函数计算两个数的和看看 AI 插件会不会自动补全代码如果不会试试用对话窗口输入同样的需求这个流程能同时验证插件的补全功能和对话功能。如果补全不工作但对话能用可能是补全功能的配置问题如果两个都不工作检查 API Key 和网络连接。提示不同 AI 插件的触发方式不一样。有的用快捷键有的用特定注释格式。装完插件先看它的文档别上来就瞎试。4.4 VS Code 与 Node.js 的联动配置VS Code 内置了 Node.js 调试功能这个对 AI 编程很有用。你可以在.vscode/launch.json里配置调试参数然后按 F5 直接调试 Node.js 代码。对于 AI 生成的代码调试能帮你快速定位问题。配置示例{ version: 0.2.0, configurations: [ { type: node, request: launch, name: 调试当前文件, program: ${file} } ] }这个配置的意思是调试当前打开的文件。保存之后打开一个.js文件按 F5 就能启动调试。AI 生成的代码如果有逻辑错误用这个方式排查比console.log高效得多。5. 常见问题排查与独家避坑经验5.1 Node.js 安装后命令不生效的排查流程这是最高频的问题。node -v报“不是内部或外部命令”按以下顺序排查排查步骤操作可能结果1检查安装路径是否存在路径不存在说明安装失败重装2检查系统 PATH 是否包含 Node.js 路径没有就手动添加3重新打开终端窗口环境变量修改需要新窗口生效4用绝对路径运行C:\Program Files\nodejs\node.exe -v能运行说明是 PATH 问题5检查是否有多个 Node.js 版本冲突卸载多余的版本我遇到过最诡异的情况是PATH 里明明有 Node.js 路径但node -v就是不行。后来发现是 PATH 里有一条错误的路径排在前面导致系统先找到了一个不存在的 node.exe。解决办法是把正确的路径移到最前面。5.2 npm 安装包失败的典型原因npm install失败的原因五花八门但常见的就那几个网络问题换国内镜像源前面已经说了权限问题不要用管理员权限跑 npm也不要在系统目录里跑Node.js 版本不匹配看报错信息里有没有engine相关的提示缓存损坏npm cache clean --force清一下缓存搜node.js v24.21.0 is not yet released or is not available这个报错的人多半是用了 nvm 切换版本但目标版本没装好。nvm 的版本列表和 Node.js 官网的发布列表有时候不同步装之前先用nvm list available看看有哪些版本可用。5.3 VS Code 插件安装失败的解决方法插件装不上先看报错信息。如果是网络超时试试在 VS Code 的settings.json里加代理配置{ http.proxy: http://你的代理地址:端口, http.proxyStrictSSL: false }如果还是不行去插件市场网页版下载.vsix文件然后在 VS Code 里用“从 VSIX 安装”的方式离线安装。这个方法虽然麻烦但成功率最高。5.4 AI 编程中的提示词技巧环境搭好之后AI 编程的体验很大程度上取决于你怎么写提示词。搜ai编程提示词能找到很多模板但核心就几条说清楚上下文不要只说“写个函数”要说“在一个 Node.js 项目里写一个读取 JSON 文件的函数用 async/await”给例子如果你有输入输出的样例直接给 AI 看分步骤复杂任务拆成多个小任务一步步让 AI 完成要求解释让 AI 解释它生成的代码这样你能学到东西也能发现潜在问题我自己的习惯是每次让 AI 生成代码之前先花 30 秒想清楚我要什么。这 30 秒能省掉后面 10 分钟的调试时间。5.5 Windows 特有的路径与权限坑Windows 的路径分隔符是反斜杠\而很多 AI 编程工具和 Node.js 包默认用正斜杠/。这会导致一些路径相关的 bug。解决办法是在代码里统一用path.join()或path.resolve()来处理路径不要手动拼字符串。权限方面Windows 的 UAC 机制有时候会阻止 Node.js 写入某些目录。如果你遇到EACCES或EPERM报错试试把项目放在用户目录下比如C:\Users\你的用户名\projects\不要放在C:\Program Files\或C:\Windows\下面。6. 环境搭好之后可以做什么6.1 用 AI 辅助写第一个完整项目环境就绪之后我建议用一个真实的小项目来练手。比如做一个命令行工具功能是读取一个 JSON 文件并格式化输出。这个项目虽小但涵盖了文件读写、参数解析、错误处理这些基础操作。你可以让 AI 生成初始代码然后自己修改、调试、优化。具体流程在 VS Code 里新建项目文件夹用npm init -y初始化然后让 AI 插件生成代码。生成之后不要直接跑先读一遍代码看看有没有明显的逻辑问题。然后运行根据报错信息让 AI 帮你修复。这个“生成-阅读-运行-修复”的循环就是 AI 编程的核心工作流。6.2 探索 AI Agent 自动化编程当你熟悉了基本的 AI 辅助编程之后可以试试 AI Agent。Agent 和普通插件的区别在于它能自动执行多步操作。比如你告诉它“帮我给这个项目加上单元测试”它会自己分析项目结构、生成测试文件、运行测试、根据结果调整。搜ai agent相关的 VS Code 插件选一个试试。Agent 类工具通常需要更详细的配置比如指定项目根目录、设置执行权限等。刚开始可能会觉得麻烦但一旦跑通效率提升非常明显。6.3 本地模型与云端 API 的取舍AI 编程工具背后要么是云端 API要么是本地模型。云端 API 的好处是模型能力强、不需要本地算力缺点是要联网、有调用成本。本地模型的好处是数据不出本地、没有调用限制缺点是对硬件有要求、模型能力通常弱一些。我的建议是日常编程辅助用云端 API敏感项目或离线场景用本地模型。本地模型可以用 Ollama 这类工具来跑装好之后在 VS Code 插件里配置本地 API 地址就行。不过本地模型对内存和显卡有要求8GB 内存起步16GB 会比较舒服。6.4 持续维护与更新策略AI 编程环境不是搭一次就完事的。Node.js 会更新VS Code 会更新AI 插件更是频繁更新。我的做法是Node.js跟着 LTS 走LTS 版本更新了再升不追 CurrentVS Code自动更新开着但大版本更新后先观察几天再升AI 插件保持最新因为新功能和新模型支持通常都在新版本里npm 全局包每隔一两个月用npm update -g更新一次更新之前最好记一下当前能用的版本组合万一更新后出问题可以回滚。我习惯在项目根目录放一个environment.md记录 Node.js 版本、npm 版本、关键插件的版本号。这个习惯帮我省过好几次重装环境的时间。6.5 从单机环境到团队协作的扩展如果你是一个人用上面这套环境就够了。但如果要团队协作还需要考虑更多代码规范怎么统一、AI 生成的代码怎么审查、API Key 怎么管理。这些话题展开就太长了但核心原则是AI 生成的代码必须经过人工审查才能合并。不要因为 AI 写得快就跳过 review这是对自己和团队负责。团队协作场景下Git 就变成必需品了。搜windows安装git命令能找到安装教程装完之后配置好用户名和邮箱就可以开始用了。Git 的基本操作不难git add、git commit、git push这三个命令能覆盖 80% 的日常使用。7. 我个人的实操体会这套环境我在三台 Windows 机器上搭过有台式机也有笔记本有 Windows 10 也有 Windows 11。最大的体会是慢就是快。每一步都验证通过再往下走比一口气装完再排查问题要快得多。Node.js 装完先跑node -vVS Code 装完先装中文包AI 插件装完先用最小流程测试。这些验证步骤花不了几分钟但能帮你省掉后面几小时的排查时间。另一个体会是不要怕重装。环境搞乱了与其花时间修不如卸载重装。Node.js 和 VS Code 的卸载都很干净重装一遍也就十几分钟。我见过有人在一个坏掉的环境上折腾了一整天最后重装半小时搞定。最后分享一个小技巧把常用的环境配置命令写成一个.ps1脚本重装系统或者换机器的时候直接跑一遍。比如设置 npm 源、设置全局目录、安装常用全局包这些操作脚本化之后一键完成。这个习惯让我从“搭环境要半天”变成了“搭环境十分钟”。