VSCode需安装Extension Pack for Java插件才能一键生成toString()方法：右键→Generate…→选toString()，依赖Language Support for Java™插件解析AST并拼接字段，支持自定义模板与null安全配置。
Java toString 方法生成：别手写，用插件一键补全
VSCode 本身不原生支持 Java 的 toString() 生成，必须依赖插件。核心路径是：装好 Extension Pack for Java（含 Language Support for Java™ by Red Hat），右键 → Generate… → 选 toString()。这步漏掉任意一个插件，菜单里根本不会出现该选项。
常见错误现象：Generate… 菜单项灰色不可点，或点了没反应——大概率是 Java 语言服务器没启动成功。检查状态栏左下角是否显示 Java Language Server: Ready；若显示 Starting… 或报错，重启 VSCode 或手动触发 Java: Clean the Java language server workspace 命令。
- 字段选择时注意：勾选
include super class fields才能继承父类字段（如AbstractEntity.id） - 默认生成用字符串拼接，若项目已引入
commons-lang3，可在设置中启用java.symbols.generateToString.useToStringBuilder开关，输出自动转为ToStringBuilder.reflectionToString(this) - 生成后记得检查 null 安全性——插件默认不加
Objects.toString(name)这类防护，字段为null时会直接拼出"null"字符串，而非跳过或显示空串
Markdown 目录自动生成：别复制粘贴，用快捷键刷新
装 Markdown All in One 后，Ctrl+Shift+P → 输入 Create Table of Contents 即可生成。但真正省事的是后续维护：只要开启 markdown.extension.toc.autoUpdate，每次保存文件，目录就自动重算锚点和层级，不用手动再跑一遍命令。
容易踩的坑：## 标题带中文 会被转成类似 #%E4%BD%BF%E7%94%A8%E6%8C%87%E5%BC%95 的 URL 编码，GitHub 渲染正常，但本地预览可能跳转失败。解决办法是关闭 markdown.extension.toc.slugifyMode，设为 github 模式（而非默认 gfm），或干脆用英文标题加空格替代中文标点。
- 目录缩进层级由
markdown.extension.toc.levels控制，默认是2-3，意思是只提取##和###级标题；若文档有####需要纳入，得改成2-4 - 生成位置由光标决定——把光标放在想要插入目录的地方（比如文档顶部），再执行命令，否则可能插到文件末尾
- 如果用了自定义锚点（如
<a id="section1"></a>），目录仍按标题文本生成链接，不会识别手动 ID，这点和 Jekyll 不同
代码片段（Snippet）：自己写模板比依赖插件更可控
很多人装一堆「Vue Snippets」「React Snippets」插件，结果发现补全内容不符合团队规范，或者字段顺序总不对。其实 VSCode 原生支持自定义 snippet，且优先级高于第三方插件——改一个 JSON 文件就能统一所有人的补全行为。
路径是 File → Preferences → Configure User Snippets → 选 javascript.json 或新建 java.json。例如 Java 中常用 getter/setter 模板，可定义：
{
"getter": {
"prefix": "get",
"body": [
"public ${1:Type} get${2:Property}() {",
" return this.${3:field};",
"}"
],
"description": "Generate getter method"
}
}关键点在于变量占位符 ${1:Type} 支持 Tab 键顺序跳转，${0} 是最终光标位置。比起插件固定的死模板，这种方式能强制字段命名风格、访问修饰符顺序、甚至加上 @NonNull 注解。
- 团队协作时，把 snippet 放进项目根目录的
.vscode/snippets/下，并在settings.json中配置"editor.snippetSuggestions": "top"，确保优先使用项目级模板 - 不要滥用
$TM_FILENAME_BASE这类内置变量——它取的是当前文件名，对User.java生成getUser()没问题，但对UserService.java就变成getUserService()，反而违背语义 - Java snippet 中慎用
$0放在方法体末尾——会导致光标停在}后面，而实际需要继续写逻辑，建议把$0放在return后或方法第一行
Live Server 自动刷新：静态资源路径错位是常见断点
Live Server 插件启动后，默认以当前打开的文件所在目录为根路径提供服务。比如你在 /src/main/webapp/index.html 上右键启动，浏览器地址就是 http://localhost:5500/src/main/webapp/index.html，但 HTML 里写的 <script src="js/app.js"> 实际请求的是 http://localhost:5500/js/app.js——路径根本对不上。
解决办法不是改 HTML 路径，而是配置插件的根目录。在项目根目录建 .vscode/settings.json，加这一行：
"liveServer.settings.CustomBrowserUrl": "http://localhost:5500/src/main/webapp/"
或者更稳妥的方式：用 liveServer.settings.root 指向正确路径，比如 "liveServer.settings.root": "./src/main/webapp"。
- 端口冲突时别硬改，先查
netstat -ano | findstr :5500（Windows）或lsof -i :5500（macOS/Linux），杀掉占用进程再启动 - 修改 CSS 后页面没刷新？检查是否启用了
liveServer.settings.AdvanceCustomBrowserUrl，这个选项会禁用 HMR，只刷新整个页面 - 如果项目用 Webpack/Vite，
Live Server就不该启用——它和热更新机制冲突，反而拖慢开发流程
自动生成不是魔法，本质是把重复劳动交给工具，但前提是你清楚每一步的边界在哪。比如 toString() 生成器不会处理循环引用，Live Server 不懂你的构建产物结构，snippet 也救不了语义错误。最常被忽略的，其实是插件之间的配置覆盖关系——两个插件都改了 editor.formatOnSave，最后生效的是谁？得去设置搜索框里看「Workspace」和「User」两栏的值来源。
