VSCode安装需选对安装包并正确配置PATH等三项，C/C++环境须确保gcc可用且c_cpp_properties.json路径无中文空格，Copilot Chat需VS Code≥1.102、启用github.copilot.chat.mcp.enabled并安装MCP Server。
VSCode 下载安装本身很简单，但**配置出错才是后续写代码卡住的真正原因**——尤其是 C/C++、Python 或带 AI 辅助的场景，环境变量、插件顺序、路径空格、中文路径这几个点，90% 的报错都源于此。
下载 VSCode 时该选哪个安装包
Windows 用户直接选 Windows 64-bit (.exe)；别点那个 “User Installer”（它默认装在用户目录，升级和权限常出问题），优先用 System Installer。Mac 用户下 .zip 就够，解压拖进 Applications 文件夹即可，不用 .dmg（签名验证容易失败）。Linux 用户按发行版选：.deb（Ubuntu/Debian）或 .rpm（Fedora/RHEL），别用 snap 版——它沙盒太严，gcc、python 调用常被拦截。
安装时必须勾选的三项 PATH 配置
安装向导第四步的选项里，只盯住这三项：
-
Add to PATH (restart needed)—— 必勾，否则终端打code .会报 “command not found” -
Add “Open with Code” to Windows Explorer context menu—— 勾，右键文件夹直接开项目省事 -
Register Code as an editor for supported file types—— 别勾，会抢走 .py/.cpp 等文件的默认打开方式，尤其影响 PyCharm 或 CLion 双开调试
装完立刻开终端输 code --version，有输出就说明 PATH 生效了；没反应就重启终端再试，别急着重装。
C/C++ 环境配不起来？先查 gcc -v 和 c_cpp_properties.json
装完 C/C++ 插件（Microsoft 官方那个）后，很多人卡在“找不到头文件”或“intellisense 不工作”。根本原因不是插件没装，而是：
- MinGW 或 MSVC 的
bin目录没进系统PATH—— 在终端跑gcc -v，有版本输出才算真装好；没输出就回头配环境变量 -
c_cpp_properties.json里"compilerPath"写的是绝对路径，且路径中不能含中文或空格（比如D:\Program Files\mingw64\bin\gcc.exe就不行，得挪到D:\mingw64\bin\gcc.exe） - 项目根目录下没建
.vscode文件夹，或没在里面手动创建c_cpp_properties.json—— VSCode 不会自动生成这个文件，必须先新建一个 C 文件、保存、再用命令面板运行C/C++: Edit Configurations (UI)才会生成
GitHub Copilot 启动失败？检查 github.copilot.chat.mcp.enabled 和模型上下文
Copilot Chat 图标点了没反应，或者提示 “No models available”，大概率是下面两个配置漏了：
- VS Code 版本必须 ≥
1.102，旧版不支持 Agent 模式，github.copilot.chat.mcp.enabled这个设置项根本不存在 - 没装
MCP Server：在扩展市场搜@mcp，点 “Browse MCP Servers”，选 GitHub 官方的 server 安装 —— 不装这个，Copilot Chat 就只是个聊天框，读不了你当前打开的文件，也执行不了命令 - 如果项目用了符号链接（比如
ln -s或 Windows junction），Copilot 会拒绝访问，报Permission denied，这时得关掉github.copilot.chat.sandbox.enabled
路径、权限、版本、配置项名称，四个地方只要一个对不上，VSCode 就会静默失败——它不报错，只不干活，这是最耗时间的坑。
