VSCode连接远程Jupyter服务器需配置内核路径与认证方式：启动带--ip=0.0.0.0和--no-browser参数的Jupyter服务，开放端口，通过VSCode Jupyter扩展输入服务器URL及token或密码完成连接，确保远程已安装并注册ipykernel。
VSCode 连接远程 Jupyter 服务器其实不难，关键是配置好内核通信路径和身份验证方式。本地 VSCode 只需把远程 Jupyter 的 kernel 识别为可用选项，就能像本地 notebook 一样编辑、运行、调试。
确认远程 Jupyter 服务已启动并允许远程访问
远程服务器上需运行带 --ip=0.0.0.0 和 --no-browser 参数的 Jupyter Lab 或 Notebook，并开放对应端口（如 8888）。推荐使用 --allow-root（仅限可信环境）或切换到普通用户启动。如果启用了 token，记下启动时输出的完整 URL 或 token 字符串；若配置了密码，确保知道密码。
- 典型启动命令：
jupyter lab --ip=0.0.0.0 --port=8888 --no-browser --allow-root - 检查防火墙是否放行端口：
sudo ufw status（Ubuntu）或firewall-cmd --list-ports（CentOS） - 如用 SSH 隧道更安全，可在本地执行：
ssh -L 8888:localhost:8888 user@remote_ip，之后访问http://localhost:8888
在 VSCode 中安装必要扩展并配置远程内核
确保已安装官方 Jupyter 扩展（Microsoft 出品）。打开 VSCode，新建或打开一个 .ipynb 文件，点击右上角的「Select Kernel」按钮（或按 Ctrl+Shift+P 输入 Select Interpreter），选择「Existing Jupyter Server」→「Enter server URL」。
- 输入格式为：
http://<remote_ip>:8888</remote_ip>（如http://192.168.1.100:8888）或http://localhost:8888（SSH 隧道场景） - 若服务启用了 token，VSCode 会弹出输入框，粘贴 token 即可；若设了密码，输入密码完成认证
- 连接成功后，VSCode 底部状态栏会显示「Jupyter Server: Connected」，Kernel 列表中会出现远程可用的 Python 环境
处理常见连接失败问题
连不上？先看错误提示关键词：「Network Error」大概率是网络/防火墙问题；「Invalid credentials」说明 token 或密码不对；「Kernel not found」可能是远程没装 ipykernel 或未注册内核。
- 远程服务器执行：
python -m ipykernel install --user --name myenv --display-name "Python (myenv)"，确保 kernel 已注册 - 检查远程
jupyter --paths输出，确认kernels/目录存在且权限正常 - VSCode 设置里关闭「Jupyter: Use Local Kernel Spec」（默认开启），避免本地 spec 覆盖远程识别
- 临时关闭远程 Jupyter 的 token 验证（仅测试用）：
--NotebookApp.token='' --NotebookApp.password=''
基本上就这些。只要远程服务可达、token 正确、kernel 可见，VSCode 就能无缝接入。不需要同步代码、不用手动上传 notebook，写完直接运行，体验接近本地开发。
