如何安装vscode并进行基础配置【教程】

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 路径）必须用绝对路径，相对路径在多工作区场景下大概率失效。