代码格式化怎么选？JS、CSS、SQL、Python 对照

#格式化改变什么、不改变什么

格式化只调整空白字符 —— 缩进、换行、空格 —— 不改变代码的语义。 这条性质是格式化工具可以放心使用的基础：格式化后的代码与原来功能完全一致，只是更易读。

需要分清的是两个相反的方向：

#JavaScript：换行不是无意义的

JavaScript 的自动分号插入（ASI）让换行位置带有语义，这是 JS 独有的一类风险。 下面两段代码含义完全不同：

class="tk-c">// 这一段返回 undefined
function f() {
  return
  { value: 1 }
}

class="tk-c">// 这一段返回对象 { value: 1 }
function f() {
  return {
    value: 1
  }
}

第一段里 return 后面跟着换行，引擎会直接插入分号，对象被当成独立语句丢弃。这类问题在压缩时尤其危险：删掉换行会让 return 和后面的表达式连在一起，语义发生变化。

安全的做法是：压缩前确认原代码在 return、break、continue、throw 后面没有裸换行，并且函数调用不要以 ( [ + - 开头另起一行。

#Python：缩进就是语法

Python 用缩进表达代码块，所以格式化必须严格保留原有的缩进层级。 这一点和 C 系语言（JS、Java、C）根本不同：后者的大括号决定结构，缩进随便排都不影响运行；Python 里缩进错了，代码要么报 IndentationError，要么逻辑直接变了。

用 Python 格式化 处理时，工具做的是「把不统一的缩进规范成 4 空格」，而不是重新推断层级。如果粘贴的代码缩进本身是错的，格式化后的结构仍然是错的 —— 这类问题需要人工确认。

#CSS：媒体查询的嵌套怎么对齐

CSS 格式化的主要价值在于把嵌套的媒体查询和选择器层级对齐。 压缩过的 CSS 通常长这样：

.a{color:red;padding:8px}@media(max-width:640px){.a{padding:4px}}

格式化后应该呈现清晰的层级，@media 内部的规则缩进一级，能一眼看出哪些样式只在特定屏幕宽度生效：

.a {
  color: red;
  padding: 8px;
}

@media (max-width: 640px) {
  .a {
    padding: 4px;
  }
}

#SQL：方言决定引号

SQL 的关键字大小写不影响执行结果，但引号符号随数据库方言变化。 这是格式化 SQL 时最容易出问题的地方：

格式化器如果统一把引号改成一种，语句在另一个数据库上就会报错。所以用 SQL 格式化 时先选对目标方言，处理完再核对一遍引号没有被改动。

另外注意：字符串字面量里的内容不会被格式化，包括里面看起来像关键字或注释的部分。这是正确行为，不需要担心。

#六种场景该用哪个工具

#常见问题

#格式化会不会改坏代码？

正常的格式化不会，因为它只操作空白字符。有两种例外需要注意：一是 Python 这类缩进敏感的语言，如果原代码缩进本身就有问题，格式化会保留这个错误；二是压缩操作，去掉换行可能在 JS 的 return 等语句处改变语义。格式化美化（beautify）通常安全，压缩（minify）需要谨慎。

#压缩后体积能小多少？

取决于原始代码的缩进与空行密度。常见量级是减少 20%~50%，其中缩进用的空格占大头 —— 用 4 空格缩进且空行较多的代码，压缩收益明显更大。注释通常也会被一并移除，如果注释需要保留（例如许可证声明），压缩前要确认工具的行为。

#格式化后还需要人工检查吗？

格式化产物建议快速扫一遍，重点看三处：字符串字面量、正则表达式、模板字符串。这三类语法里可能出现与代码语法相似的字符，是最容易出问题的地方。另外 SQL 要核对引号、Python 要核对缩进层级。

#为什么格式化报错了？

格式化工具内部需要先解析代码，解析失败就会中止并报错。这通常意味着代码本身有语法错误：括号不匹配、引号未闭合、缺少逗号。报错位置通常指向问题所在或附近，可以先手工修掉再重试。

#格式化会保留注释吗？

美化会保留；压缩通常移除，因为注释不参与执行、又占体积。如果你需要保留许可证声明这类法律要求的注释，应该在压缩后手工补回，或者使用支持保留特定注释的构建工具处理。

#想统一团队代码风格，用在线工具够吗？

不够。在线工具适合处理零散的片段，团队协作应该用编辑器插件或构建流程里的格式化器（如 Prettier、Black、gofmt），让保存时自动执行 —— 这样风格统一是靠工具保证的，不依赖每个人的习惯。在线工具更适合「快速看清一段陌生代码」这个场景。