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 打开扩展面板,搜名字安装后,必须手动检查配置:
大小仅1兆左右 ,足够轻便的商城系统; 易部署,上传空间即可用,安全,稳定; 容易操作,登陆后台就可设置装饰网站; 并且使用异步技术处理网站数据,表现更具美感。 前台呈现页面,兼容主流浏览器,DIV+CSS页面设计; 如果您有一定的网页设计基础,还可以进行简易的样式修改,二次开发, 发布新样式,调整网站结构,只需修改css目录中的css.css文件即可。 商城网站完全独立,网站源码随时可供您下载
-
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 路径)必须用绝对路径,相对路径在多工作区场景下大概率失效。









