VS Code 开发环境配置指南

在日常开发中，合理配置 VS Code 能够显著提升开发效率。本文记录了一些实用的 VS Code 配置技巧，帮助你打造更舒适的开发环境。

代理配置

基础代理设置

由于某些扩展插件需要访问外网资源，我们需要为 VS Code 配置网络代理：

{
    "http.proxy": "http://127.0.0.1:7890"
}

使用本地代理就不需要配置代理地址，会从本地env环境中寻找代理地址：

{
    "http.useLocalProxyConfiguration": true
}

端口转发配置

在进行容器化开发时，VS Code 的自动端口转发功能默认只监听 localhost。为了让局域网内的其他设备也能访问，需要调整监听地址：

{
    "remote.localPortHost": "allInterfaces"
}

这样配置后，端口转发将监听 0.0.0.0，允许局域网内的用户通过你的 IP 地址访问转发的端口。

文件嵌套优化建议

在项目开发中，相关文件如果能以父子嵌套的方式在资源管理器中展示，将显得结构更加清晰，便于管理和查找。你可以通过如下配置启用文件嵌套功能：

"explorer.fileNesting.enabled": true

推荐嵌套配置示例

父文件	子文件（自动嵌套显示）
Pipfile	Pipfile.lock
.env	.env*（如 .env.local、.env.dev 等）
pyproject.toml	uv.lock

说明

• Pipfile：将 Pipfile.lock 作为子文件嵌套，可以快速定位依赖及其锁定文件。
• .env：所有以 .env 开头的环境配置文件均作为 .env 的子项，便于统一管理环境变量。
• pyproject.toml：将依赖锁定文件 uv.lock 作为子项归类，保持 Python 项目根目录整洁。

使用ruff格式化python代码

Ruff 是一个用 Rust 编写的极快速的 Python 代码检查工具和格式化工具，可以替代 Flake8、Black、isort 等工具，同时执行速度更快。

1.安装ruff扩展
2.安装ruff本身

pip install ruff

3.配置 Ruff

按下Cmd+Shift+P，搜索Open Settings (JSON), 添加如下配置

{
  // 仅对 python 文件生效
  "[python]": {
    "editor.formatOnSave": true,
    "editor.defaultFormatter": "charliermarsh.ruff",
    "editor.codeActionsOnSave": {
      "source.fixAll": "explicit",
      "source.organizeImports": "explicit"
    }
  },
  // notebook    
  "notebook.formatOnSave.enabled": true,
  "notebook.codeActionsOnSave": {
    "notebook.source.fixAll": "explicit",
    "notebook.source.organizeImports": "explicit"
  },
  "ruff.nativeServer": "on",
  "ruff.logLevel": "info",
  "ruff.logFile": "/path/to/ruff.log",
  "ruff.trace.server": "messages",
  "ruff.lineLength": 88  // 设置代码行长度为 88
}

其他实用配置

TODO:

---

相关链接：

• VS Code 官方配置文档
• VS Code 远程开发指南