新建项目前须确认VS Code已安装对应扩展：微信小程序需minapp扩展和wechat-devtools；Taro项目需Taro Tools扩展及全局@tarojs/cli；纯静态工具装Live Server即可；所有依赖模块的项目必须执行npm init -y生成package.json。
新建项目前先确认 VS Code 已装对的扩展
VS Code 本身不带编译器或运行环境，写小程序 ≠ 装完 VS Code 就能跑。关键看你要写哪种“小程序”：微信小程序、Taro 项目、uni-app，还是纯前端 HTML+JS 小工具？不同目标依赖不同扩展和命令行工具。
常见错误现象：npm run dev 报错 command not found，或点击调试按钮没反应——大概率是没装对应扩展，或没在终端里全局安装 CLI 工具。
实操建议：
- 微信小程序：必须装官方
minapp扩展（非“WeChat Mini Program”等仿名插件），并用wechat-devtools配合；VS Code 里只能编辑，不能直接预览 - Taro 项目：装
Taro Tools扩展，且本地需有@tarojs/cli（用npm install -g @tarojs/cli安装） - 纯静态小工具（比如一个计算器 HTML 页面）：只需装
Live Server扩展，右键Go Live即可实时刷新
初始化项目别跳过 package.json 这一步
很多人直接建 index.html 写代码，结果后续加 axios 或 lodash 时发现模块找不到——因为没初始化 npm 项目，node_modules 根本不存在，import 会直接报 Cannot find module。
使用场景：只要涉及第三方库、ES6 模块导入、或未来要打包（比如用 Vite 启动），就必须有 package.json。
实操建议：
- 打开终端，cd 到空文件夹，运行
npm init -y（快速生成默认package.json） - 如果要用现代语法（如
import），再补一句npm set-script dev "vite"，然后装vite：npm install vite --save-dev - 别手动创建
package.json文件——少一个逗号或引号都会导致npm拒绝解析
调试时别只盯着 F5，先看终端输出和 launch.json 类型
F5 启动失败最常见原因不是代码错，而是调试配置没对上运行环境。比如你写了个 Node.js 小脚本，但 .vscode/launch.json 里选的是 Chrome 启动器，自然报 Unable to launch browser。
参数差异：不同运行时需要不同的 type 值——node、pwa-node、chrome、pwa-msedge，不能混用。
实操建议：
- 按
Ctrl+Shift+P（Win）或Cmd+Shift+P（Mac），输入Debug: Open launch.json，选对应环境（如Node.js） - 检查
configurations[0].program是否指向正确的入口文件，比如"${workspaceFolder}/src/index.js"，而不是"index.html" - 如果只是想看 console 输出，直接在集成终端里运行
node index.js更快，F5 是为断点服务的
保存自动格式化失效？多半是没配对 defaultFormatter
写完代码按 Ctrl+S 没反应，或者格式化后缩进全乱，通常不是插件坏了，而是 VS Code 不知道该用谁来格式化——尤其混用 JS/TS/JSON 时，每种语言要单独指定格式化器。
性能影响：装了 Prettier 但没设为 JavaScript 默认格式化器，VS Code 就会 fallback 到内置格式器，结果 JSX 里属性换行、单双引号风格全崩。
实操建议：
- 打开设置（
Ctrl+,），搜format on save，确保勾选 - 再搜
default formatter，分别点击JavaScript、TypeScript、JSON语言的下拉菜单，选esbenp.prettier-vscode - 如果项目根目录有
.prettierrc，就别在设置里硬编码 tabWidth —— 优先级低于配置文件，容易覆盖失败
复杂点在于：有些小程序框架（比如 Taro）会自动生成临时文件，这些文件可能被格式化器误处理。遇到保存后代码莫名变样，先关掉工作区的 format on save，单独对源码文件夹启用。
