li旭旭前阵子帮两个刚入职的同事配置开发环境，发现一个特别普遍的现象：装VSCode都很顺利，一卡就卡在Node.js和npm上。要么是官网下载链接选错，要么装完之后在终端敲npm -v直接弹出一片红色报错——"npm : 无法加载文件 C:\Program Files\nodejs\npm.ps1，因为在此系统上禁止运行脚本"。看着吓人，其实每个错误背后都有一个很具体的原因，而且大多一两分钟就能解决。
这篇文章把我平时给新人搭环境、以及自己反复踩过多次坑的完整流程整理出来：从VSCode常用扩展包怎么选，到Node.js安装的版本和安装选项，再到npm包安装、镜像源配置、常见报错的处理思路。适合刚接触前端和Node.js的初学者，也适合准备重装系统、需要快速恢复开发环境的老手。看完之后不需要靠搜索去拼凑答案，照着做就行。
1. 先把VSCode装对：下载渠道、安装模式与中文界面
1.1 官网下载避坑：真的没必要用第三方打包版
很多人搜索"vscode下载"，习惯性点了搜索结果里的广告位，下回来一个所谓的"绿色版""高速版"。这类第三方打包版我强烈不建议碰，一方面是版本滞后，另一方面你根本不知道安装包里被塞了什么额外东西。VSCode本来就是免费开源的，官方下载入口就一个：code.visualstudio.com，认准这个域名就行。
进入官网后，首页会根据系统自动显示大下载按钮。Windows用户注意下载页里有下拉选项，能看到User Installer和System Installer两个下载项，还有64位、32位和ARM版的区分，绝大多数现代电脑选64位即可。
顺带说一个冷门情况：还在用Windows 7的机器，VSCode从1.70版本之后就停止支持了，所以老系统要么用1.70.x的最后一个兼容版本，要么考虑升级系统。这不是玄学，是官方的系统支持策略，遇到新版打不开时先查这条。
1.2 用户安装 vs 系统安装：我为什么推荐非管理员方案
安装包的两个类型，很多人是第一次见：
| 安装类型 | 默认安装位置 | 是否需要管理员权限 | 适用场景 |
|---|---|---|---|
| User Installer（用户安装） | %LocalAppData%\Programs\Microsoft VS Code |
不需要 | 个人日常开发 |
| System Installer（系统安装） | C:\Program Files\Microsoft VS Code |
需要 | 多用户共用、IT统一部署 |
如果是自己一个人用电脑，优先选User Installer。原因很实际：安装时不弹UAC权限确认，后续更新时也不会频繁碰到"没有写入权限"的报错。公司电脑没有管理员权限时，更是只有User Installer能装成功。
安装过程中的选项有一个强烈建议保留：勾选"通过Code命令打开操作目录"。它会在PATH里注册code命令，之后你可以在任意终端输入code .直接打开当前文件夹到VSCode。这个命令用顺了之后，很多操作都能在一个终端里完成。
1.3 中文界面与第一个扩展的设置路径
装好打开默认是英文。切中文有两种方式：一是在扩展商店搜索"Chinese (Simplified)"，装完重启；二是用命令面板Ctrl+Shift+P，输入"Configure Display Language"选zh-cn。效果一样，看哪个顺手。
VSCode最大的优势就是扩展机制：编辑器本身轻量，功能全靠扩展叠加。扩展入口在左侧Extensions图标（快捷键Ctrl+Shift+X），搜索名字安装即可。另外建议登录账号开启Settings Sync，它会把扩展列表、设置、快捷键同步到微软或GitHub账号，换电脑时自动恢复。我重装系统后十分钟还原全部开发环境，靠的就是这个。
需要模型API调用？ 免费领10W Token，多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 常用扩展包清单：按开发方向选装，不要一条龙堆满
2.1 通吃型基础扩展：任何项目都用得上
下面这几个是跨语言、跨项目的基础配置，也是我给新环境装的"默认套餐"：
| 扩展名 | 作用 | 备注 |
|---|---|---|
| Prettier - Code formatter | 统一代码风格，保存时自动格式化 | 团队协作必装，避免格式争论 |
| ESLint | JS/TS静态检查，发现问题类型与未用变量 | 和Prettier配合互补 |
| Error Lens | 把错误信息直接显示在代码行尾 | 不用悬停看红波浪线，效率提升明显 |
| Path Intellisense | 输入文件路径时自动补全 | 写import和资源引用时很舒服 |
| GitLens | 查看每行代码的修改历史和作者 | 大型仓库可能略重，但信息量很大 |
| Bookmarks | 代码书签，快速跳转 | 看长文件时强烈推荐 |
注意一点：扩展不是越多越好。很多扩展常驻后台进程，装多了VSCode启动会变慢、内存占用上升。我自己习惯只保留这套基础清单，其他扩展按项目需要临时加，项目做完可以按需禁用在用的扩展，保持环境清爽。
2.2 按语言方向选装：Python、C/C++、前端怎么配
- Python组：装官方Python扩展（
ms-python.python），它会自动带上Pylance和调试支持。做数据分析再加Jupyter扩展。需要提醒的是，VSCode的Python扩展大部分工作还是围绕解释器环境，虚拟环境的创建和激活依然要在终端里自己执行。 - C/C++组：直接搜"C/C++ Extension Pack"（
ms-vscode.cpptools-extension-pack），会一次性装好智