想让 Fitten Code 在特定项目中自动按照你的编码风格进行缩进、换行和注释格式化，而不使用全局默认配置，就需要启用项目级配置——它会优先覆盖用户级设置，并且只影响当前文件夹及其子目录。操作非常简单：在项目根目录创建一个 .fittenrc 文件，使用 JSON 格式定义 language、indentSize 等字段，然后保存并重启编辑器，即可看到效果。

确认项目根目录存在 .fittenrc 配置文件

首先，找到项目最外层文件夹——也就是包含 package.json、src/ 或 pyproject.toml 的那个目录。检查该目录下是否存在一个名为 .fittenrc 的隐藏配置文件。如果不存在，直接用编辑器新建一个。

这一步非常重要：Fitten Code 仅识别项目根目录下的 .fittenrc，如果将其放置在 src/ 或其他子目录中，配置文件将完全被忽略，相当于白费功夫。

用 JSON 格式写入个性化规则

打开 .fittenrc 文件，粘贴以下基础结构：

{
"language": "python",
"indentSize": 4,
"insertFinalNewline": true,
"generateCommentStyle": "google"
}

重点关注 "language" 字段：它必须与当前项目使用的主语言完全一致（支持 python、javascript、java、typescript 等 80 多种语言）。如果拼写错误，整个配置会被自动忽略。

另外需要提醒：JSON 语法必须严格——字段名必须小写，引号必须是英文双引号，逗号不能缺失。一旦出现语法错误，Fitten Code 会静默丢弃这个文件，既不报错也不提示，届时只能自行排查问题。

覆盖常用开发习惯的 3 种典型配置

下面列举几种常见场景的配置示例，直接复制并根据需要修改即可使用。

方法一：强制统一 Python 缩进与 docstring 格式
"indentSize": 4 → 所有新生成的 Python 代码使用 4 空格缩进；
"generateCommentStyle": "numpy" → 自动生成的函数注释采用 NumPy 风格，而非默认的 Google 风格；
"autoInsertSemicolon": false → 关闭分号自动插入功能（Python 确实不需要它）。

方法二：JavaScript 项目禁用 Prettier 冲突项
"formatOnSave": false → 禁止 Fitten Code 在保存时触发格式化，避免与本地已安装的 Prettier 插件产生冲突；
"quoteType": "single" → 所有字符串默认使用单引号；
"trailingComma": "es5" → 对象或数组末尾逗号仅在 ES5+ 环境下保留。

方法三：Java 项目定制单元测试生成行为
"testFramework": "junit5" → 指定生成 @Test 方法时使用 JUnit 5 注解；
"mockStrategy": "mockito" → 自动生成 mock 对象时优先调用 Mockito；
"skipNullCheck": true → 生成断言时不自动添加非空校验（适用于已经明确判空的场景）。

验证配置是否生效

配置完成后，如何确认它已经生效？

第一步：关闭所有 VS Code 窗口，重新通过命令行进入项目根目录，然后执行 code . 启动编辑器。

第二步：新建一个 .py 文件，输入 def hello() -> str: 触发代码补全，观察函数体是否自动缩进 4 格，生成的 docstring 是否为你设定的 NumPy 风格。

第三步：如果配置未生效，打开命令面板（Ctrl+Shift+P），运行 Fitten Code: Reload Configuration，然后重新尝试。

这一步操作起来非常简单，直接将文件拖进去即可——当然，前提是路径和语法都正确无误。