简介这份PDF面向零基础编程学习者与刚接触开发环境搭建的初学者围绕VSCode这款微软出品的跨平台免费源代码编辑器讲清从获取到上手使用的完整脉络。内容涵盖软件定位与核心功能说明、官方下载渠道与版本选择、安装向导中各步骤的取舍、中文语言包的安装与界面切换以及插件按需扩展、项目文件夹导入与文件创建等常见入门环节也提及设置优化与后续学习方向。文件为单个PDF压缩包约2.12MB轻量易存适合离线阅读或打印成纸质笔记随手翻阅已有1496人学习下载。对于不熟悉安装选项、语言包配置或不清楚VSCode为何没有新建项目入口的读者可借此理清安装路径选择、开始菜单添加、附加任务勾选等细节并了解如何通过导入文件夹配合HTML等文件创建来组织第一个工程减少自行摸索的时间。1. 编辑器只是壳子一份 PDF 教程能省掉的四十分钟第一次在自己机器上装 VSCode 的人往往不是被代码难住的。装软件、改语言、找目录、新建文件、配插件这几件事单独拎出来都不复杂但拼在一起就会出现奇怪的状态界面全是英文、文件夹拖进去打不开、写好的 HTML 双击预览一片空白。这份《VSCode下载与安装使用教程.pdf》处理的就是这堆“看不见的摩擦”——它按介绍、下载、安装、使用、基础知识、新建项目六段走了一遍完整路径图文对照适合从零开始配环境的新手也适合要把机器交给别人、需要一份可照抄清单的从业者。全文只有一条主线把安装到跑通第一份文件的流程压平不涉及深度 C 配置或远程开发别指望它解决进阶问题。2. 安装包里藏着的选择版本、路径与勾选项安装这一步看起来是“下一步、下一步”实际有三个决策点会影响到后面几个月。教程里把安装过程拆成“协议 → 路径 → 开始菜单 → 勾选项 → 安装”五步顺序本身没毛病但 PDF 是静态的它没法告诉你“这一步为什么”。把这三处补上安装就不再是玄学。2.1 从官方下载页挑对版本教程给的是官方站点code.visualstudio.com上的“Download for Windows”按钮并提示点旁边的下拉箭头可以选其他版本。这一步在实操中最容易翻车的地方是版本名看不懂Windows 版分 User Installer 和 System Installer前者只给当前用户装不写系统目录、免管理员权限后者装到全局多用户共用。教程没细说区别常见做法是个人开发机一律选 User Installer公司统一发的机器选 System Installer。另外两个入口值得记住.zip免安装包适合拷到 U 盘或没写权限的机器Linux 那边是.deb/.rpm/.tar.gz三种对应的安装命令完全不同。教程面向 Windows跨平台部分只有一句“根据情况选择”所以 Linux 用户拿这份 PDF 只能当流程参考命令得自己补。安装包类型适用场景是否需要管理员更新方式User Installer个人机器、单用户否编辑器内自动更新System Installer多用户共用机器是需重新安装或管理员更新.zip 免安装便携、无写权限环境否手动替换目录表格里这一行“更新方式”是 PDF 没写的但很关键User 版更新是静默的System 版在企业环境里常常因为权限而不弹更新提示用半年后版本落后一大截却毫无感知。2.2 安装向导里那两个必须想清楚的勾选项教程在第四步写“根据需要勾选”这五个字是整份文档最含糊的一句。真实安装向导里那一页有几个选项其中两个影响日常使用频率极高“将‘通过 Code 打开’操作添加到 Windows 资源管理器文件/目录上下文菜单”——勾上之后右键文件夹直接进编辑器是这个软件最顺手的入口建议必勾。“将 Code 注册为受支持的文件类型的编辑器”——会让.txt、.js等文件的默认打开方式被改掉如果你机器上还装着别的编辑器这一项慎勾。“添加到 PATH”——命令行里敲code .能直接打开当前目录做前端和脚本的人必须勾不勾的话后面所有命令行流程都得手动绕。装完之后建议立刻验证一次别等写代码时才发现 PATH 没生效# 验证命令行入口是否可用 code --version # 输出应包含版本号、提交哈希和 CPU 架构例如 1.x.x / xxxxxxx / x64 # 用当前目录作为工作区打开验证目录参数是否被正确接收 code .第一条命令返回三段信息才算装对了如果提示“不是内部或外部命令”说明 PATH 没写进系统环境变量要么重装时勾选该项要么手动把安装目录下的bin子目录加进 PATH 再开一个新终端。注意必须开新终端旧终端读的是启动时的环境变量快照这是新手最容易卡住的一步。2.3 装完先做三件事别急着写代码按教程的顺序装完直接进“开始使用”。我一般会插三步进去把后面所有麻烦提前挡掉装中文语言包。教程第四部分第一条就是它在扩展面板搜 Chinese装完点提示里的重启。要说明的是这里装的是语言包扩展界面语言变了但扩展本身没变如果重启后还是英文按CtrlShiftP打开命令面板输入Configure Display Language手动选zh-cn。确认工作区信任机制。第一次打开别人的文件夹会弹“是否信任此工作区的作者”选不信任的话很多功能会被限制这时候别以为是插件坏了。摸一遍设置入口。教程里“点击调整我的设置”指向的是设置页实际开发中真正要记的是两条路径图形化设置页Ctrl,和底层settings.json。前者改主题、字号后者改编译参数、格式化规则二者改的是同一份配置后者优先级更高。3. 中文界面、插件与第一个文件把空壳变成工作台装完的编辑器是个空壳能打开文件但不会帮你干活。教程的后半段其实在讲“怎么把这个壳子配置成一个能写代码的环境”只是它用了截图式的叙述缺少“为什么这么配”的因果。这一章把它的步骤接起来并补上它省略掉的验证动作。3.1 语言包安装与界面切换中文语言包的安装路径是左侧活动栏的扩展图标 → 搜索Chinese (Simplified)→ Install → 弹窗里的 Restart。这里有个细节语言包是官方维护的扩展名字里带 Simplified 和 Traditional 两个选错会得到繁体界面虽然不影响功能但菜单名和很多教程对不上查资料时会多绕一圈。切换语言还有一条更稳的路径不走弹窗// 打开命令面板CtrlShiftP执行 Preferences: Configure Language // 或在 settings.json 中确认这一行存在 { locale: zh-cn }这个配置项写进用户设置后重启即生效不依赖语言包是否弹了重启提示。遇到“装了中文包界面还是英文”的情况八成是这一项被某次同步覆盖回了en或者机器上装了多个版本、你改的不是当前运行的那个。3.2 按需装语言插件别一次装一屏教程写“点击浏览语言拓展可以按需安装语言插件”这句话的正确理解是编辑器本体只带语法高亮真正的智能补全、跳转定义、重构都靠语言扩展。安装原则按项目来不按兴趣来。以写前端为例最小可用组合通常只有两个一个语言支持扩展 一个格式化工具。Python 那边则是官方 Python 扩展加一个静态检查器。装多了的直接后果不是变慢而是同一个文件被多个格式化器争抢保存时格式反复横跳这是很多人遇到的“保存后代码自己变了”的根源。# 用命令行批量装扩展适合新机器初始化 code --install-extension ms-ceintl.vscode-language-pack-zh-hans code --install-extension dbaeumer.vscode-eslint # 列出已装扩展排查“到底是谁在改我的文件” code --list-extensions第一条是中文语言包的扩展标识后一条是常见的 JS 检查工具仅作示例按你的技术栈替换。--list-extensions这条命令在排错时价值很高当保存行为异常先看列表里是不是装了两个功能重叠的扩展再逐个禁用定位比盲猜快得多。3.3 新建项目没有“新建项目”按钮这件事教程第六部分开篇就点破了很多人第一次用时的困惑这个编辑器没有“新建项目”这个动作它的模型是“打开文件夹即工作区”。所以流程变成手动建目录、再导入。# 1. 建项目目录名字自定这里用示例名 mkdir my-first-site cd my-first-site # 2. 建入口文件 touch index.html # 3. 用编辑器打开这个目录作为工作区 code .三步里第三步最关键。用code .打开左侧资源管理器显示的是整个目录树后续新建文件、搜索、Git 操作都以这个目录为根如果只是把单个文件拖进窗口编辑器处在“单文件模式”很多能力不可用比如工作区级设置、调试配置。这个区别教程只用“手动新建文件夹导进去”一句带过但它决定了后面所有操作是否顺畅。建好index.html后写一段最小内容然后验证两件事保存时是否有格式化动作、右键菜单里有没有“在浏览器中打开”类的扩展入口。前者验证格式化器是否生效后者验证你装的扩展是否真的挂上了。教程到“例如HTML”就结束了实际到这一步还差一个预览闭环所以文档本身更适合当安装清单不适合当完整入门教材。4. 避坑与排查五条装完才会遇到的真实问题4.1 现象命令行敲 code 没反应原因有三类安装时没勾“添加到 PATH”勾了但终端是安装前就开着的机器上装过便携版PATH 指向了一个已被删除的目录。解决顺序是先在终端执行where codeWindows或which codemacOS / Linux看解析到哪个路径。没有输出就是 PATH 缺失重装并勾选该项最省事输出指向不存在的位置就去系统环境变量里把那条废路径删掉。改完必须新开终端验证不要在原窗口里反复试。4.2 现象中文包装了界面还是英文原因通常是语言配置项被覆盖或者安装的是繁体语言包而菜单名对不上误以为没生效。解决办法是走命令面板的Configure Display Language手动选简体中文后重启仍不生效就打开用户settings.json检查locale字段确认值是zh-cn。还有一种少见情况机器上同时存在用户版和系统版你装语言包的是 A打开的却是 B此时code --version的输出路径能帮你确认到底在跑哪个。4.3 现象保存后代码格式自己变了原因是有两个以上扩展在争抢格式化权常见于同时装了通用格式化器和语言专用格式化器。解决方式是在设置里明确指定默认格式化器并关掉其余扩展的“保存时格式化”。验证方法是打开一个文件、改一处缩进、保存、看变化是否符合预期如果仍乱用code --list-extensions列出全部扩展逐个禁用二分定位。血泪经验是不要靠猜靠二分。4.4 现象打开文件夹后大量功能不可用原因是工作区信任机制。第一次打开来源不明的目录时选了“不信任”编辑器会进入受限模式调试、任务、部分扩展全部禁用。解决方式是命令面板执行Workspaces: Manage Workspace Trust把当前目录加入信任列表这属于安全机制不要为了省事全局关闭。受限模式下顶部通常有提示条看到它就别再怀疑插件坏了。4.5 现象按教程找不到对应按钮原因是版本差异。这份 PDF 的截图对应的是某个较早的界面布局新版把“欢迎页”“设置入口”“扩展详情页”的按钮位置调过有的还改了名字。解决办法是记住功能的命令名而不是按钮位置按CtrlShiftP输入关键词如settings、language、extension用命令面板直达。这个习惯能让你在任何版本上都不迷路也是这份静态教程最需要读者自己补上的一课。5. 把配置变成可复制的资产设置同步与初始化脚本新手期过去之后真正省时间的不是记住每个按钮在哪而是让一台新机器在十分钟内回到你熟悉的状态。这个编辑器自带设置同步能力配合一个初始化脚本就能把“装环境”这件事从手工活变成一条命令的事。设置同步的入口在左下角账户菜单里开启后会同步设置、快捷键、已装扩展、代码片段。要注意同步的是“哪些项”而不是“全部项”语言相关的本地路径、某些需要登录的扩展不会被同步。所以我的习惯是同步之外再维护一份扩展清单文本放在自己的笔记里换机器时先同步、再对一遍清单、最后手工补两三个需要凭证的扩展。下面这个脚本是我在新机器上跑的第一条命令集思路是把“验证 → 装扩展 → 开目录”串起来#!/usr/bin/env bash # 新机器初始化先验证入口再按清单装扩展最后打开工作目录 set -e # 1. 确认命令行入口可用失败则直接退出避免后面全错 code --version /dev/null || { echo code 命令不可用先修 PATH; exit 1; } # 2. 按清单安装扩展标识逐行写重复执行不会报错 for ext in \ ms-ceintl.vscode-language-pack-zh-hans \ dbaeumer.vscode-eslint \ esbenp.prettier-vscode do code --install-extension $ext --force done # 3. 打印当前扩展列表方便和笔记里的清单比对 code --list-extensions # 4. 打开项目目录作为工作区 code ~/projects/demo脚本里的set -e让任何一步失败就停下避免在半坏的状态下继续装--force的作用是已装扩展也重新走一遍安装流程适合版本不一致时强制对齐最后一行换成你自己的项目路径。这套东西的价值不在于脚本多聪明而在于它把“我是不是漏装了什么”这个反复出现的疑问变成了一次可对比的输出。还有一个细节值得单独提工作区级设置和用户级设置的优先级。团队项目里常见做法是在项目根目录建.vscode/settings.json把格式化器、缩进、排除目录写进去跟仓库一起提交。这样别人克隆下来就有一致的编辑行为不用口头交代。要注意别把个人偏好主题、字号写进工作区文件那会让协作者被强行改观感。从那以后我每次配新机器都强制先跑一遍code --version和扩展清单比对再动手装任何东西——因为踩过太多次“以为装好了其实跑的是旧版本”的坑。希望帮到你。本文还有配套的精品资源点击获取 
长河君 · 2026/11/4 7:42:53 · 阅读 1.2k VSCode下载安装使用教程：PATH、中文包与扩展排错
简介这份PDF面向零基础编程学习者与刚接触开发环境搭建的初学者围绕VSCode这款微软出品的跨平台免费源代码编辑器讲清从获取到上手使用的完整脉络。内容涵盖软件定位与核心功能说明、官方下载渠道与版本选择、安装向导中各步骤的取舍、中文语言包的安装与界面切换以及插件按需扩展、项目文件夹导入与文件创建等常见入门环节也提及设置优化与后续学习方向。文件为单个PDF压缩包约2.12MB轻量易存适合离线阅读或打印成纸质笔记随手翻阅已有1496人学习下载。对于不熟悉安装选项、语言包配置或不清楚VSCode为何没有新建项目入口的读者可借此理清安装路径选择、开始菜单添加、附加任务勾选等细节并了解如何通过导入文件夹配合HTML等文件创建来组织第一个工程减少自行摸索的时间。1. 编辑器只是壳子一份 PDF 教程能省掉的四十分钟第一次在自己机器上装 VSCode 的人往往不是被代码难住的。装软件、改语言、找目录、新建文件、配插件这几件事单独拎出来都不复杂但拼在一起就会出现奇怪的状态界面全是英文、文件夹拖进去打不开、写好的 HTML 双击预览一片空白。这份《VSCode下载与安装使用教程.pdf》处理的就是这堆“看不见的摩擦”——它按介绍、下载、安装、使用、基础知识、新建项目六段走了一遍完整路径图文对照适合从零开始配环境的新手也适合要把机器交给别人、需要一份可照抄清单的从业者。全文只有一条主线把安装到跑通第一份文件的流程压平不涉及深度 C 配置或远程开发别指望它解决进阶问题。2. 安装包里藏着的选择版本、路径与勾选项安装这一步看起来是“下一步、下一步”实际有三个决策点会影响到后面几个月。教程里把安装过程拆成“协议 → 路径 → 开始菜单 → 勾选项 → 安装”五步顺序本身没毛病但 PDF 是静态的它没法告诉你“这一步为什么”。把这三处补上安装就不再是玄学。2.1 从官方下载页挑对版本教程给的是官方站点code.visualstudio.com上的“Download for Windows”按钮并提示点旁边的下拉箭头可以选其他版本。这一步在实操中最容易翻车的地方是版本名看不懂Windows 版分 User Installer 和 System Installer前者只给当前用户装不写系统目录、免管理员权限后者装到全局多用户共用。教程没细说区别常见做法是个人开发机一律选 User Installer公司统一发的机器选 System Installer。另外两个入口值得记住.zip免安装包适合拷到 U 盘或没写权限的机器Linux 那边是.deb/.rpm/.tar.gz三种对应的安装命令完全不同。教程面向 Windows跨平台部分只有一句“根据情况选择”所以 Linux 用户拿这份 PDF 只能当流程参考命令得自己补。安装包类型适用场景是否需要管理员更新方式User Installer个人机器、单用户否编辑器内自动更新System Installer多用户共用机器是需重新安装或管理员更新.zip 免安装便携、无写权限环境否手动替换目录表格里这一行“更新方式”是 PDF 没写的但很关键User 版更新是静默的System 版在企业环境里常常因为权限而不弹更新提示用半年后版本落后一大截却毫无感知。2.2 安装向导里那两个必须想清楚的勾选项教程在第四步写“根据需要勾选”这五个字是整份文档最含糊的一句。真实安装向导里那一页有几个选项其中两个影响日常使用频率极高“将‘通过 Code 打开’操作添加到 Windows 资源管理器文件/目录上下文菜单”——勾上之后右键文件夹直接进编辑器是这个软件最顺手的入口建议必勾。“将 Code 注册为受支持的文件类型的编辑器”——会让.txt、.js等文件的默认打开方式被改掉如果你机器上还装着别的编辑器这一项慎勾。“添加到 PATH”——命令行里敲code .能直接打开当前目录做前端和脚本的人必须勾不勾的话后面所有命令行流程都得手动绕。装完之后建议立刻验证一次别等写代码时才发现 PATH 没生效# 验证命令行入口是否可用 code --version # 输出应包含版本号、提交哈希和 CPU 架构例如 1.x.x / xxxxxxx / x64 # 用当前目录作为工作区打开验证目录参数是否被正确接收 code .第一条命令返回三段信息才算装对了如果提示“不是内部或外部命令”说明 PATH 没写进系统环境变量要么重装时勾选该项要么手动把安装目录下的bin子目录加进 PATH 再开一个新终端。注意必须开新终端旧终端读的是启动时的环境变量快照这是新手最容易卡住的一步。2.3 装完先做三件事别急着写代码按教程的顺序装完直接进“开始使用”。我一般会插三步进去把后面所有麻烦提前挡掉装中文语言包。教程第四部分第一条就是它在扩展面板搜 Chinese装完点提示里的重启。要说明的是这里装的是语言包扩展界面语言变了但扩展本身没变如果重启后还是英文按CtrlShiftP打开命令面板输入Configure Display Language手动选zh-cn。确认工作区信任机制。第一次打开别人的文件夹会弹“是否信任此工作区的作者”选不信任的话很多功能会被限制这时候别以为是插件坏了。摸一遍设置入口。教程里“点击调整我的设置”指向的是设置页实际开发中真正要记的是两条路径图形化设置页Ctrl,和底层settings.json。前者改主题、字号后者改编译参数、格式化规则二者改的是同一份配置后者优先级更高。3. 中文界面、插件与第一个文件把空壳变成工作台装完的编辑器是个空壳能打开文件但不会帮你干活。教程的后半段其实在讲“怎么把这个壳子配置成一个能写代码的环境”只是它用了截图式的叙述缺少“为什么这么配”的因果。这一章把它的步骤接起来并补上它省略掉的验证动作。3.1 语言包安装与界面切换中文语言包的安装路径是左侧活动栏的扩展图标 → 搜索Chinese (Simplified)→ Install → 弹窗里的 Restart。这里有个细节语言包是官方维护的扩展名字里带 Simplified 和 Traditional 两个选错会得到繁体界面虽然不影响功能但菜单名和很多教程对不上查资料时会多绕一圈。切换语言还有一条更稳的路径不走弹窗// 打开命令面板CtrlShiftP执行 Preferences: Configure Language // 或在 settings.json 中确认这一行存在 { locale: zh-cn }这个配置项写进用户设置后重启即生效不依赖语言包是否弹了重启提示。遇到“装了中文包界面还是英文”的情况八成是这一项被某次同步覆盖回了en或者机器上装了多个版本、你改的不是当前运行的那个。3.2 按需装语言插件别一次装一屏教程写“点击浏览语言拓展可以按需安装语言插件”这句话的正确理解是编辑器本体只带语法高亮真正的智能补全、跳转定义、重构都靠语言扩展。安装原则按项目来不按兴趣来。以写前端为例最小可用组合通常只有两个一个语言支持扩展 一个格式化工具。Python 那边则是官方 Python 扩展加一个静态检查器。装多了的直接后果不是变慢而是同一个文件被多个格式化器争抢保存时格式反复横跳这是很多人遇到的“保存后代码自己变了”的根源。# 用命令行批量装扩展适合新机器初始化 code --install-extension ms-ceintl.vscode-language-pack-zh-hans code --install-extension dbaeumer.vscode-eslint # 列出已装扩展排查“到底是谁在改我的文件” code --list-extensions第一条是中文语言包的扩展标识后一条是常见的 JS 检查工具仅作示例按你的技术栈替换。--list-extensions这条命令在排错时价值很高当保存行为异常先看列表里是不是装了两个功能重叠的扩展再逐个禁用定位比盲猜快得多。3.3 新建项目没有“新建项目”按钮这件事教程第六部分开篇就点破了很多人第一次用时的困惑这个编辑器没有“新建项目”这个动作它的模型是“打开文件夹即工作区”。所以流程变成手动建目录、再导入。# 1. 建项目目录名字自定这里用示例名 mkdir my-first-site cd my-first-site # 2. 建入口文件 touch index.html # 3. 用编辑器打开这个目录作为工作区 code .三步里第三步最关键。用code .打开左侧资源管理器显示的是整个目录树后续新建文件、搜索、Git 操作都以这个目录为根如果只是把单个文件拖进窗口编辑器处在“单文件模式”很多能力不可用比如工作区级设置、调试配置。这个区别教程只用“手动新建文件夹导进去”一句带过但它决定了后面所有操作是否顺畅。建好index.html后写一段最小内容然后验证两件事保存时是否有格式化动作、右键菜单里有没有“在浏览器中打开”类的扩展入口。前者验证格式化器是否生效后者验证你装的扩展是否真的挂上了。教程到“例如HTML”就结束了实际到这一步还差一个预览闭环所以文档本身更适合当安装清单不适合当完整入门教材。4. 避坑与排查五条装完才会遇到的真实问题4.1 现象命令行敲 code 没反应原因有三类安装时没勾“添加到 PATH”勾了但终端是安装前就开着的机器上装过便携版PATH 指向了一个已被删除的目录。解决顺序是先在终端执行where codeWindows或which codemacOS / Linux看解析到哪个路径。没有输出就是 PATH 缺失重装并勾选该项最省事输出指向不存在的位置就去系统环境变量里把那条废路径删掉。改完必须新开终端验证不要在原窗口里反复试。4.2 现象中文包装了界面还是英文原因通常是语言配置项被覆盖或者安装的是繁体语言包而菜单名对不上误以为没生效。解决办法是走命令面板的Configure Display Language手动选简体中文后重启仍不生效就打开用户settings.json检查locale字段确认值是zh-cn。还有一种少见情况机器上同时存在用户版和系统版你装语言包的是 A打开的却是 B此时code --version的输出路径能帮你确认到底在跑哪个。4.3 现象保存后代码格式自己变了原因是有两个以上扩展在争抢格式化权常见于同时装了通用格式化器和语言专用格式化器。解决方式是在设置里明确指定默认格式化器并关掉其余扩展的“保存时格式化”。验证方法是打开一个文件、改一处缩进、保存、看变化是否符合预期如果仍乱用code --list-extensions列出全部扩展逐个禁用二分定位。血泪经验是不要靠猜靠二分。4.4 现象打开文件夹后大量功能不可用原因是工作区信任机制。第一次打开来源不明的目录时选了“不信任”编辑器会进入受限模式调试、任务、部分扩展全部禁用。解决方式是命令面板执行Workspaces: Manage Workspace Trust把当前目录加入信任列表这属于安全机制不要为了省事全局关闭。受限模式下顶部通常有提示条看到它就别再怀疑插件坏了。4.5 现象按教程找不到对应按钮原因是版本差异。这份 PDF 的截图对应的是某个较早的界面布局新版把“欢迎页”“设置入口”“扩展详情页”的按钮位置调过有的还改了名字。解决办法是记住功能的命令名而不是按钮位置按CtrlShiftP输入关键词如settings、language、extension用命令面板直达。这个习惯能让你在任何版本上都不迷路也是这份静态教程最需要读者自己补上的一课。5. 把配置变成可复制的资产设置同步与初始化脚本新手期过去之后真正省时间的不是记住每个按钮在哪而是让一台新机器在十分钟内回到你熟悉的状态。这个编辑器自带设置同步能力配合一个初始化脚本就能把“装环境”这件事从手工活变成一条命令的事。设置同步的入口在左下角账户菜单里开启后会同步设置、快捷键、已装扩展、代码片段。要注意同步的是“哪些项”而不是“全部项”语言相关的本地路径、某些需要登录的扩展不会被同步。所以我的习惯是同步之外再维护一份扩展清单文本放在自己的笔记里换机器时先同步、再对一遍清单、最后手工补两三个需要凭证的扩展。下面这个脚本是我在新机器上跑的第一条命令集思路是把“验证 → 装扩展 → 开目录”串起来#!/usr/bin/env bash # 新机器初始化先验证入口再按清单装扩展最后打开工作目录 set -e # 1. 确认命令行入口可用失败则直接退出避免后面全错 code --version /dev/null || { echo code 命令不可用先修 PATH; exit 1; } # 2. 按清单安装扩展标识逐行写重复执行不会报错 for ext in \ ms-ceintl.vscode-language-pack-zh-hans \ dbaeumer.vscode-eslint \ esbenp.prettier-vscode do code --install-extension $ext --force done # 3. 打印当前扩展列表方便和笔记里的清单比对 code --list-extensions # 4. 打开项目目录作为工作区 code ~/projects/demo脚本里的set -e让任何一步失败就停下避免在半坏的状态下继续装--force的作用是已装扩展也重新走一遍安装流程适合版本不一致时强制对齐最后一行换成你自己的项目路径。这套东西的价值不在于脚本多聪明而在于它把“我是不是漏装了什么”这个反复出现的疑问变成了一次可对比的输出。还有一个细节值得单独提工作区级设置和用户级设置的优先级。团队项目里常见做法是在项目根目录建.vscode/settings.json把格式化器、缩进、排除目录写进去跟仓库一起提交。这样别人克隆下来就有一致的编辑行为不用口头交代。要注意别把个人偏好主题、字号写进工作区文件那会让协作者被强行改观感。从那以后我每次配新机器都强制先跑一遍code --version和扩展清单比对再动手装任何东西——因为踩过太多次“以为装好了其实跑的是旧版本”的坑。希望帮到你。本文还有配套的精品资源点击获取