Windsurf 配置笔记
一、介绍
在 VScode 上写python 有几个非常尴尬的bug:
- LSP (Language Server Protocol,语言服务器协议)误报严重:

- 内置的copilot 非常笨,且吵:
导致代码自动补全非常难用,总给出一些愚不可及的补全。
相信用VScode 开发过Python的朋友都知道我在说什么…体验比Pycharm差很多。
和朋友友好沟通之后,发现了 Windsurf 这款编辑器(IDE),除了vscode版,也有jetbrains的插件。
和cursor类似,套壳vscode,增加一些AI功能,但是更符合程序员的习惯。
个人认为,Claude 这种“软件”,更适合产品经历,只提需求,AI员工完成。
但是这种做课题的,代码如果要开源,就要经得起考验,还是自己手搓放心,所以和Claude的配合更像是某种和同事的协作。接下来看看windsurf有哪些令人心动的功能吧!
二、Windsurf
下载:Windsurf - The best AI for Coding
与cursor配置类似,与vscode完全兼容,支持配置直接导入。官方也有教程:欢迎使用 Windsurf - Windsurf Docs
到手先安装一些常用的插件:
这都是一些我个人的习惯。现在基本和之前VScode的界面一致了,能用 Claude 和调试功能。
那么相对于原版vscode,增加了哪些功能呢?
1. 函数功能提示

众所周知 python是弱类型语言,所以提示比较差。但是在windsurf中,鼠标悬浮在函数上之后,会自动生成一个中文概要。如果还看不懂,可以直接右键 see wiki,会自动去调用deepwiki的接口:
2. AI自动补全
这个功能用了一段时间后感觉和copliot大差不差,也没有很聪明,属于凑合,但是是免费的,copliot pro需要学生认证才可以。功能在右下角的 setting 中可以开启关闭
软件自带的AI也是免费的,目前还有免费kimi2.5,pro版本开放opus 4.6 和sonet 4.5 ,做一些简单任务的时候比如读代码的时候可以使用,也是比较好用的。 ctrl + shift + I 就可以呼出cascade了。
并且支持ai在指定位置写,或者修改指定位置代码,这部分在Command - Windsurf Docs就不赘述了。
3. codemap
这个用来熟悉项目结构也是很好用的,他会自动生成一个代码结构图,然后就基于他给的结构开始熟悉源码就好了
4. 更好用的搜索替换
VScode原版的搜索挺难用的,windsurf直接专门接出来了,直接全局搜索,还支持AI替换,好用
三、结语
Pro版本是每月20美元,有点肉疼
支持国内直接访问,但是有opus,sonnet,GPT5.4,无需翻墙,非常友好
,并且看起来对华友好,不会搞幺蛾子