vs code不新建项目,需手动创建目录、虚拟环境并配置解释器;未保存、未装依赖、终端环境错是运行失败主因;跳转失效需配extrapaths或__init__.py。

VS Code 本身不“写项目”,它只编辑、运行、调试项目——项目结构、代码逻辑、依赖管理,全靠你自己组织或借助工具生成。
怎么新建一个能跑起来的项目(以 Python 为例)
VS Code 没有“新建项目”菜单项,它只管打开文件夹。真正建项目,得先在终端里初始化:
- 用
mkdir myproject && cd myproject创建空目录 - 用
python -m venv .venv建虚拟环境(别漏掉.venv这个名字,VS Code 默认识别它) - 用
code .在当前目录启动 VS Code(不是code myproject,否则可能打开错路径) - 打开后按
Ctrl+Shift+P(macOS 是Cmd+Shift+P),搜Python: Select Interpreter,选中.venv/bin/python(Linux/macOS)或.venv\Scripts\python.exe(Windows)
这时候才算有了可运行的 Python 项目基础——没这步,import 会报错,扩展也认不出环境。
为什么改了代码却看不到效果(常见运行失败场景)
VS Code 不自动保存、不自动重启、不自动安装依赖。三个最常卡住人的点:
支持静态模板,支持动态模板标签,支持图片.SWF.FLV系列广告标签.支持百万级海量数据,绑定内置URL伪装策略(URL后缀名随你怎么写),绑定内置系统升级策略(暂不开放升级),绑定内置模板付费升级策略(暂不开放更新)。支持标签容错处理,绑定内置攻击防御策略,绑定内置服务器优化策略(系统内存释放的干干净净)。支持离线运行,支持次目录,兼容U主机。支持会员功能,支持文章版块权限阅读,支持会员自主注册
- 文件没保存就点运行:看右上角文件名有没有 *,或者关掉自动保存前,务必按
Ctrl+S - 用了新库但没装:比如写了
import requests却报ModuleNotFoundError,得在集成终端里手动运行pip install requests - 终端用的是系统 Python,不是你选的那个
.venv:检查终端左下角 Python 解释器路径是否匹配,不匹配就关掉终端重开,或点击路径手动切换
尤其注意:VS Code 的“运行 Python 文件”(绿色三角)本质就是调 python xxx.py,它不会帮你激活虚拟环境,只认你选中的解释器路径。
怎么让 Ctrl+Click 跳转到自己写的模块(而不是进 site-packages)
跳转失效,大概率是 VS Code 没把当前目录当源码根——它默认只索引打开的文件,不递归理解包结构:
- 确保项目根目录下有
__init__.py(哪怕为空),否则 VS Code 不认为这是 Python 包 - 如果模块在子目录如
src/utils.py,而主脚本在main.py,直接from utils import xxx会失败;得加sys.path.append("src")或配置python.defaultInterpreterPath不够,要配python.extraPaths - 推荐做法:在项目根建
pyproject.toml或setup.py,再在 VS Code 设置里把python.defaultInterpreterPath指向.venv,并确保python.analysis.extraPaths包含["src"]
这个配置藏得深,且不同 Python 扩展版本行为不一致——老项目升级插件后跳转突然失效,八成是 extraPaths 没同步更新。
项目不是靠编辑器“写”出来的,而是靠你定义结构、声明依赖、选择工具链。VS Code 只负责把这一切串起来,串歪了,它不会提醒你——比如 requirements.txt 里写错版本,它照样让你运行;比如 __pycache__ 被 git 忽略,它也不会告诉你测试时用的是旧字节码。









