VS Code需下载官方版本并完成基础配置才能正常使用；须设置自动保存、等宽字体及终端默认Shell，安装Python、Prettier和中文语言包扩展并正确配置路径，终端中文乱码需检查系统locale和编码设置。
VS Code 不需要传统意义上的“安装”，直接下载解压就能用；但跳过配置直接写代码，很快会遇到中文乱码、终端打不开、扩展不生效等问题。
下载官方版本，别碰第三方打包版
官网 code.visualstudio.com 提供 Windows（.exe/.zip）、macOS（.zip/.dmg）、Linux（.deb/.rpm/.tar.gz）三类包。Windows 用户优先选 System Installer（自动注册右键菜单和文件关联），避免用 User Installer（某些企业环境策略会拦截）。Mac 用户必须从官网下，别用 Homebrew 安装的 vscode（它默认不带图形界面权限，调试终端常失败）。
- 下载后 Windows 双击
VSCodeSetup-x64-*.exe，勾选「Add to PATH」和「Add "Open with Code" action」 - macOS 解压后拖入
/Applications，首次运行要右键 → 「打开」绕过 Gatekeeper - Linux 的
.deb用sudo apt install ./code_*.deb，别用dpkg -i（依赖可能缺失）
启动后立刻改这三项基础设置
按 Ctrl+,（Win/Linux）或 Cmd+,（Mac）打开设置，搜索并修改：
-
"files.autoSave": "onFocusChange"—— 切换文件时自动保存，避免关窗口丢代码 -
"editor.fontFamily": "'Fira Code', 'Consolas', 'monospace'"—— 中文系统下必须显式指定等宽字体，否则默认用微软雅黑导致对齐错乱 -
"terminal.integrated.defaultProfile.linux": "bash"（Linux）或"terminal.integrated.defaultProfile.osx": "zsh"（Mac）—— 否则终端启动失败或命令不识别
必装的三个扩展及其关键配置项
按 Ctrl+Shift+X 打开扩展面板，搜名字安装后，必须手动检查配置：
-
Python（微软官方）：安装后需在设置里指定python.defaultInterpreterPath，指向你实际的python3路径（如/usr/bin/python3或~/miniconda3/bin/python），否则调试器根本找不到解释器 -
Prettier：启用后要关掉editor.formatOnSave的全局开关，改用"editor.formatOnSave": true+"editor.defaultFormatter": "esbenp.prettier-vscode"，否则和其他格式化工具冲突 -
Chinese (Simplified) Language Pack：装完需重启 VS Code，且仅翻译界面，不影响代码行为
终端中文显示异常？重点查 locale 和编码
如果集成终端（Ctrl+`）里中文显示为方块或问号，不是字体问题，而是系统 locale 未生效：
- Linux/macOS 运行
locale，确认LANG是zh_CN.UTF-8或en_US.UTF-8；如果不是，临时修复：export LANG=zh_CN.UTF-8 - Windows 终端需在 VS Code 设置里加：
"terminal.integrated.env.windows": { "CHCP": "65001" }（启用 UTF-8 代码页） - 别试图在
settings.json里改"terminal.integrated.fontSize"来“解决”乱码——这是掩耳盗铃
配置最易被忽略的点是：所有路径类配置（Python 解释器、Prettier 配置文件位置、自定义 snippets 路径）必须用绝对路径，相对路径在多工作区场景下大概率失效。
