1. 为什么要在 Windows 上认真搭一套 AI 编程环境很多人第一次接触 AI 编程都是被各种演示视频吸引的一句话生成一个网页、几秒钟补全一整段函数、对着编辑器说句话就把 bug 修了。但真到自己动手第一步就卡住了——环境装不起来。Node.js 版本对不上、VS Code 插件报错、终端里命令找不到、AI 助手连不上模型折腾一晚上代码一行没写心态先崩了。我自己在 Windows 上给团队搭过不下二十套开发环境从纯小白到有经验的开发者都带过。踩过的坑包括但不限于装了两个版本的 Node.js 导致全局包互相打架、VS Code 插件因为网络问题一直转圈、PowerShell 执行策略把脚本全拦下来、Git 没配好导致 AI 工具拉取仓库失败。这些问题单独看都不难但凑在一起就非常消耗耐心。这篇内容就是把这些年攒下来的经验整理成一条清晰的路径。核心目标很明确在一台干净的 Windows 机器上从零搭起一套能跑 AI 编程的完整环境包括运行时、编辑器、版本控制、AI 辅助插件以及必要的容器化工具。适合完全没配过环境的新手也适合想把自己环境重新梳理一遍的老手。关键词里的Windows、AI、编程环境、Node.js、VS Code会贯穿全文每一步我都会说清楚为什么这么做和不这么做会怎样。需要提前说明的是AI 编程环境这几年变化很快工具链迭代频繁。我下面给出的版本号和配置是基于当前主流稳定版本你在实际操作时可能会遇到更新的版本思路是一致的遇到差异按逻辑调整即可。2. 环境搭建前的整体规划与工具清单2.1 先想清楚这套环境要支撑什么动手装软件之前先明确这套环境要干什么。AI 编程场景大致分三类第一类是本地写代码、调用云端 AI 服务做补全和对话第二类是本地跑 AI 模型做推理第三类是两者混合。绝大多数人属于第一类也就是需要一个顺手的编辑器和稳定的网络调用能力本地不需要显卡。这个判断很重要因为它直接决定了你要装什么。如果只是第一类那核心就是 Node.js 运行时、VS Code 编辑器、Git 版本控制加上 AI 插件。如果涉及第二类那还要考虑 Python 环境、CUDA 驱动、模型文件管理那是另一个量级的事情。本文聚焦第一类也就是最普遍、门槛最低、收益最直接的场景。我见过不少人一上来就想本地跑大模型结果显卡不够、内存爆掉最后连基本的代码补全都用不上。先把轻量路径跑通再考虑进阶这是更务实的顺序。2.2 工具清单与各自的分工把要装的东西列成一张表心里有数装的时候不容易乱。工具作用是否必装备注Node.jsJavaScript 运行时很多 AI 工具和 CLI 依赖它必装建议 LTS 版本VS Code代码编辑器AI 插件的主要载体必装官方渠道下载Git版本控制AI 工具拉取代码和依赖的基础必装顺带装 Git BashWindows Terminal更好的终端体验推荐微软商店可装Python部分 AI 工具链依赖按需建议 3.10 以上Docker Desktop容器化隔离环境按需涉及后端服务时用这张表里前三项是地基。Node.js 之所以关键是因为现在大量 AI 编程工具、CLI 助手、插件后端都是用 JavaScript/TypeScript 写的没有它很多工具根本跑不起来。VS Code 则是目前 AI 插件生态最丰富的编辑器没有之一。Git 看似和 AI 无关但几乎所有 AI 工具在初始化项目、拉取依赖、管理版本时都会调用它。2.3 安装顺序为什么不能乱顺序这件事很多人不当回事结果就是反复重装。正确的顺序是先装系统级的基础工具Git、Node.js再装编辑器VS Code最后装插件和配置。原因很简单VS Code 的很多插件在安装时会去检测系统里有没有 Node.js、有没有 Git如果这些还没装插件要么装不上要么装上了也报错。还有一个细节装 Node.js 之前先确认系统里没有残留的旧版本。Windows 上很容易出现控制面板里卸载了但环境变量还留着的情况导致新版本装了但命令行调用的还是旧的。这个坑我在第 5 节会详细讲怎么排查。3. Node.js 在 Windows 上的安装与版本管理实战3.1 为什么 Node.js 是 AI 编程环境的第一块基石先解释一下 Node.js 到底是什么。简单说它是一个让 JavaScript 能脱离浏览器、直接在电脑上运行的环境。浏览器里的 JavaScript 只能操作网页而 Node.js 让 JavaScript 能读写文件、发起网络请求、启动服务。AI 编程工具大量使用这套能力比如一个 AI 代码补全插件的后台进程很可能就是一个 Node.js 程序。版本问题是最容易出事的。Node.js 有 LTS长期支持和 Current最新特性两条线。AI 工具通常要求 LTS 版本因为稳定。但有些新工具会要求较新的版本比如要求 18 以上甚至 20 以上。如果你装了个太老的版本插件会直接报不支持装了个太新的 Current 版本又可能遇到某些依赖还没适配。我的建议是主力用当前最新的 LTS 版本同时用版本管理工具保留一个备用版本。这样遇到兼容性问题可以快速切换不用卸载重装。3.2 安装包方式与版本管理方式的取舍Windows 上装 Node.js 有两种主流方式。第一种是去官网下载.msi安装包双击一路下一步。第二种是用版本管理工具比如nvm-windows或fnm。安装包方式的好处是简单直接适合完全新手。坏处是只能装一个版本想换版本得卸载重装而且卸载经常卸不干净。版本管理方式的好处是可以同时装多个版本一条命令切换坏处是初次配置稍微麻烦一点。我的实际经验是如果你只是临时用用安装包够了。但如果你打算长期做 AI 编程强烈建议用版本管理工具。因为 AI 工具链更新快今天要求 18明天可能要求 20有版本管理工具你会轻松很多。下面给出nvm-windows的实操步骤这是 Windows 上比较成熟的方案。3.3 nvm-windows 的完整安装流程第一步先彻底清理系统里已有的 Node.js。打开设置 - 应用找到所有 Node.js 相关的条目卸载。然后检查环境变量右键此电脑 - 属性 - 高级系统设置 - 环境变量在用户变量和系统变量里找有没有NODE_PATH、NODE_OPTIONS这类残留有就删掉。再检查Path变量里有没有指向旧 Node.js 安装目录的条目一并清理。第二步下载nvm-windows的安装包。注意要下载nvm-setup.exe这个版本不要下免安装的 zip因为 setup 版本会自动帮你配好环境变量。第三步安装过程中会有两个路径要选。第一个是 nvm 自己的安装目录建议放在C:\Users\你的用户名\AppData\Roaming\nvm。第二个是 Node.js 的软链接目录默认是C:\Program Files\nodejs保持默认即可。这个软链接目录很关键它始终指向当前激活的那个 Node.js 版本环境变量里配的就是它。第四步安装完成后打开一个新的终端一定要新开否则环境变量不生效输入nvm version如果能看到版本号说明装好了。然后安装一个 LTS 版本nvm install lts nvm use lts再验证node -v npm -v两个命令都能输出版本号就说明 Node.js 环境通了。3.4 版本切换与常见报错处理装好之后切换版本就是一行命令nvm list nvm use 20.11.0nvm list会列出所有已安装的版本nvm use切换。切换后记得重新开终端或者在某些终端里需要重新加载配置。这里有个高频报错值得单独说The requested module node:util does not provide an export named ...。这个错误通常出现在 Node.js 18 环境下运行某些较新的工具时本质是工具用到了更高版本才有的 API。解决办法不是去改工具代码而是升级 Node.js 版本。这也是为什么我建议保留多个版本遇到这种问题直接nvm use切到 20 或更高版本就行。另一个常见问题是node.js v24.21.0 is not yet released or is not available这通常是你指定了一个不存在的版本号。用nvm list available查看真实可用的版本列表别凭记忆写版本号。提示每次用 nvm 切换版本后全局安装的 npm 包不会跟着走。也就是说你在版本 A 下装的全局工具切到版本 B 后就用不了了。这是 nvm 的设计不是 bug。解决办法是在每个版本下重新装一遍需要的全局工具或者用项目级的本地依赖代替全局依赖。4. VS Code 的安装、汉化与 AI 插件生态配置4.1 从官方渠道获取安装包的重要性VS Code 一定要从官网下载。网上有很多所谓的绿色版优化版免安装版这些版本可能被篡改过或者缺少自动更新能力更重要的是可能捆绑了你不想要的东西。官方版本免费安装包也不大没有任何理由用第三方版本。下载时注意选对系统架构。现在大部分电脑是 64 位选x64的User Installer或System Installer。两者的区别是User Installer 只给当前用户装不需要管理员权限System Installer 给所有用户装需要管理员权限。个人电脑用 User Installer 就够了。安装过程中有一个选项值得勾选添加到 PATH。勾上之后你可以在终端里直接用code .命令打开当前目录非常方便。其他选项按默认走就行。4.2 中文语言包的安装与界面适配VS Code 默认是英文界面。如果你更习惯中文装一个中文语言包即可。打开 VS Code按CtrlShiftX打开扩展面板搜索Chinese找到微软官方发布的Chinese (Simplified) Language Pack点击安装。安装完成后右下角会弹出提示点击Change Language and Restart重启即可。这里提醒一句语言包只影响界面文字不影响代码和命令。有些教程会建议新手不要用中文界面理由是很多报错信息是英文的看中文界面会造成割裂。我的看法是界面用中文没问题但报错信息要养成看英文原文的习惯因为搜索解决方案时英文关键词命中率更高。4.3 AI 编程插件的选型逻辑VS Code 的 AI 插件现在非常多选哪个是很多人纠结的问题。我把它们大致分几类帮你理清思路。第一类是代码补全型主打在你打字时预测下一段代码代表是各种 Copilot 类工具。第二类是对话型侧边栏开个聊天窗口你可以问它问题、让它改代码。第三类是 Agent 型能自主执行多步任务比如读文件、改代码、跑命令。第四类是 CLI 伴侣型把命令行 AI 工具和编辑器打通。选型的核心不是哪个最强而是哪个最匹配你的工作流。如果你大部分时间在写重复性代码补全型收益最大。如果你经常需要理解陌生代码库对话型更合适。如果你想让它帮你完成整个小任务Agent 型更省事。安装插件时有个通用注意事项装完之后通常需要登录账号或配置 API Key。这一步如果卡住先检查网络再检查账号状态最后检查插件版本是否和 VS Code 版本兼容。插件报错时点开输出面板CtrlShiftU看具体日志比盲目重装有效得多。4.4 插件冲突与性能问题的排查AI 插件装多了会互相打架这是真实存在的问题。典型表现是补全提示延迟很高、编辑器卡顿、有时候两个插件的提示框叠在一起。排查方法是二分法。先禁用一半插件看问题是否消失。如果消失说明问题在被禁用的那半里再细分。如果没消失说明在另一半里。这样几轮就能定位到具体是哪个插件。另一个常见问题是插件导致 VS Code 启动变慢。可以在命令面板CtrlShiftP里运行Developer: Startup Performance它会列出各个插件的启动耗时耗时异常的插件考虑禁用或替换。注意AI 插件通常会持续占用一定的 CPU 和内存尤其是开启了实时补全的。如果你的电脑配置一般建议只保留一到两个核心 AI 插件不要贪多。5. Git、终端与系统级配置的收尾工作5.1 Git 安装与身份配置Git 是版本控制工具AI 编程工具在初始化项目、拉取依赖、管理代码版本时都会用到它。Windows 上装 Git 推荐从官网下载安装包安装时有一个选项叫 Git Bash Here建议勾上它会给你一个类 Unix 的命令行环境很多 AI 工具的命令示例都是基于这种环境的。安装完成后第一件事是配置身份git config --global user.name 你的名字 git config --global user.email 你的邮箱这两条信息会写进你每一次提交记录里不配的话提交会报错。邮箱建议用你代码托管平台注册的那个这样提交记录能正确关联到你的账号。还有一个配置建议开启避免 Windows 和 Unix 换行符差异导致的诡异问题git config --global core.autocrlf true5.2 Windows Terminal 与 PowerShell 执行策略Windows 自带的终端体验一般建议装一个 Windows Terminal微软商店直接搜就能装。它支持多标签、分屏、自定义主题配合 Git Bash 或 PowerShell 都好用。PowerShell 有一个默认的执行策略会阻止脚本运行。很多 AI 工具的安装脚本是.ps1文件直接跑会被拦下来报无法加载文件因为在此系统上禁止运行脚本。解决办法是以管理员身份打开 PowerShell运行Set-ExecutionPolicy -Scope CurrentUser RemoteSigned这个设置的意思是本地写的脚本可以跑从网上下载的脚本需要有签名。比直接设成Unrestricted安全又能解决大部分问题。5.3 环境变量与路径问题的系统排查环境变量是 Windows 上最容易出问题的地方。核心概念是Path变量它是一串目录列表系统在执行命令时会去这些目录里找对应的程序。如果某个工具装了但命令行找不到八成是它的目录没进Path。排查步骤打开环境变量设置看Path里有没有对应工具的目录。改完之后一定要新开终端因为环境变量是终端启动时读取的已经开着的终端不会自动更新。还有一个隐蔽的坑Path里如果有多个指向不同 Node.js 版本的目录系统会按顺序找找到第一个就用。这就是为什么用 nvm 之前要清理旧版本的环境变量否则 nvm 切换了版本实际调用的还是旧版本。6. 从零到跑通第一个 AI 辅助项目的完整验证6.1 创建项目并初始化环境装完必须跑一个真实项目验证否则你不知道哪里还有问题。打开终端建一个测试目录mkdir ai-hello cd ai-hello npm init -ynpm init -y会生成一个默认的package.json这是 Node.js 项目的配置文件。然后装一个轻量的依赖测试网络和 npm 是否正常npm install dayjs如果这一步能成功说明 Node.js、npm、网络这条链路是通的。6.2 写一段代码并让 AI 插件介入新建一个index.js写几行代码const dayjs require(dayjs); function greet(name) { const now dayjs().format(YYYY-MM-DD HH:mm:ss); return 你好 ${name}现在是 ${now}; } console.log(greet(AI 编程));运行node index.js能看到输出说明运行时没问题。接下来测试 AI 插件把光标放在greet函数里触发补全通常是打字或者按快捷键看插件是否能给出建议。如果插件有对话功能选中这段代码问它这段代码有什么可以改进的地方看它是否能正常响应。这一步是整套环境的验收测试。补全能触发、对话能响应说明 AI 编程环境真正跑通了。6.3 用 Git 做一次完整提交最后用 Git 走一遍流程验证版本控制链路git init git add . git commit -m 初始化 AI 编程测试项目如果提交成功说明 Git 配置正确。到这里一套完整的 AI 编程环境就算搭好了。7. 环境维护与长期使用的经验总结7.1 定期更新与版本锁定环境搭好不是一劳永逸。Node.js 会发新版本VS Code 会自动更新AI 插件更是几天一个版本。我的建议是Node.js 保持 LTS 版本不必追新VS Code 让它自动更新AI 插件更新前看一眼更新日志如果只是小版本修复就更新如果是大版本变更先观望几天看社区反馈。项目层面package.json里的依赖版本要锁定。用package-lock.json记录精确版本这样换机器或者过几个月重装装出来的依赖是一致的不会因为依赖升级导致项目跑不起来。7.2 备份你的配置VS Code 有一个内置的配置同步功能登录账号后可以同步插件列表、设置、快捷键。强烈建议开启这样换电脑或者重装系统后登录一下配置就回来了不用一个个重装插件。Git 的全局配置、npm 的全局配置、终端配置这些建议单独记一个文档把关键命令和路径记下来。我自己的习惯是维护一个setup-notes.md每次配新机器就照着走一遍省时省力。7.3 遇到问题时的排查顺序最后分享一套我常用的排查顺序遇到环境问题按这个顺序走能解决八成情况。第一看报错原文不要只看中文翻译去搜英文关键词。第二确认命令是在正确的目录下执行的。第三确认环境变量是否生效新开终端试试。第四确认版本是否匹配Node.js 版本、插件版本、工具要求的版本。第五看日志VS Code 的输出面板、npm 的 debug 日志、Git 的详细输出都有线索。第六实在不行就重装但重装前先记录下当前配置避免重装后又要重新摸索。这套环境我自己用了很久也帮不少人搭过。最大的体会是慢就是快。装的时候每一步都验证一下比装完一堆再一起排查要省时间得多。环境这东西稳比新重要能跑通比功能全重要。