VS Code 的 .vscode/settings.json 仅对当前工作区生效，无法自动按子目录或子模块继承不同 Python 格式化配置；需通过多根工作区（Multi-root Workspace）或语言特定设置组合实现真正的差异化 Black 参数（如 --line-length）。
vs code 的 `.vscode/settings.json` 仅对当前工作区生效，无法自动按子目录或子模块继承不同 python 格式化配置；需通过多根工作区（multi-root workspace）或语言特定设置组合实现真正的差异化 black 参数（如 `--line-length`）。
在大型项目中，主仓库与子模块可能遵循不同的代码风格规范（例如 PEP 8 兼容性要求、团队约定或历史遗留约束），尤其在 Black 格式化器的 --line-length 设置上常需差异化：主仓库和 sub_01 使用 150 字符，而 sub_02 严格限制为 100 字符。但直接在各子目录下放置独立的 .vscode/settings.json 并不能生效——VS Code 不支持“嵌套工作区继承”机制，它只会加载最外层打开的文件夹（即 main_repo/）的设置，子目录中的 settings.json 被完全忽略。
✅ 正确解法是使用 VS Code 多根工作区（Multi-root Workspace）：
- 在
main_repo/目录下创建一个工作区文件，例如main_repo.code-workspace； - 编辑该文件，显式声明所有需独立配置的路径：
{
"folders": [
{
"path": "."
},
{
"path": "subs/sub_01"
},
{
"path": "subs/sub_02"
}
],
"settings": {}
}
- 关闭当前窗口，用 VS Code 打开该
.code-workspace文件（而非单纯打开文件夹）； - 此时每个文件夹将作为独立“根文件夹”，VS Code 支持为其分别配置
settings.json：-
main_repo/.vscode/settings.json→ 控制主仓库行为； -
main_repo/subs/sub_01/.vscode/settings.json→ 仅作用于sub_01； -
main_repo/subs/sub_02/.vscode/settings.json→ 仅作用于sub_02。
-
例如，在 sub_02/.vscode/settings.json 中可精确指定：
{
"[python]": {
"editor.formatOnSave": true,
"editor.defaultFormatter": "ms-python.black-formatter"
},
"black-formatter.args": ["--line-length=100"],
"python.defaultInterpreterPath": "./venv/bin/python"
}
⚠️ 注意事项：
- 确保已安装 Python 扩展 和 Black Formatter 扩展（v2023.10+）；
-
black-formatter.args是扩展级配置，不支持通配符或条件判断，必须静态定义； - 若启用
editor.formatOnType，建议统一设为false（Black 不支持实时格式化）； - 工作区设置优先级高于用户设置，但低于文件级设置（如
# fmt: off注释）； - 避免在
.vscode/中提交敏感配置（如 token、本地路径），推荐使用.vscode/settings.json+.gitignore过滤。
? 补充方案（轻量级）：若无法使用多根工作区，可借助 Black 的配置文件层级机制，在各子模块根目录放置 pyproject.toml：
# subs/sub_02/pyproject.toml [tool.black] line-length = 100 include = '\.pyi?$'
VS Code 的 Black 扩展会自动读取该配置（需确保 black-formatter.args 未覆盖 --line-length，即完全删除该字段，交由 Black 自动发现）。
总结：VS Code 单一文件夹模式下无法实现子模块级 Black 差异化配置；唯一可靠路径是采用多根工作区 + 分散 .vscode/settings.json，辅以 pyproject.toml 声明式配置提升可移植性与团队一致性。
