直接原因是/tmp空间耗尽或内存配置不合理，而非Pylance自身bug；远程开发中需通过~/.vscode-server/server-env-setup.sh设置TMPDIR和NODE_OPTIONS，而非~/.bashrc，因VS Code Remote启动时未加载shell配置文件。
直接原因往往是 /tmp 空间耗尽或内存配置不合理，而不是 Pylance 本身有 bug。尤其在远程开发（Remote-SSH）场景下，/tmp 满导致 mkdir '/tmp/pyright-<pid>-<random>'</random></pid> 失败，会直接触发进程退出，且不重试。
为什么改 TMPDIR 在 ~/.bashrc 里没用
Pylance（实为 Pyright 启动器）在 VS Code Server 进程初始化极早期就尝试创建临时目录，此时 shell 配置文件（如 ~/.bashrc、~/.zshrc）甚至 ~/.profile 都尚未被 source。VS Code Remote 的 extension host 和 language server 启动流程绕过了用户 shell 初始化阶段。
真正生效的时机点只有一个：~/.vscode-server/server-env-setup.sh —— 它是 VS Code Remote 官方文档明确支持的、最早可干预的环境变量注入机制，会在 server 启动时被 source，对所有后续进程（包括 Pylance worker）生效。
操作步骤：
- 在远程服务器上执行：
mkdir -p ~/.vscode-server - 创建文件：
vim ~/.vscode-server/server-env-setup.sh - 写入两行（路径替换成你自己有写权限且空间充足的位置，比如
~/tmp）：export TMPDIR=/home/yourname/tmp export TMP=/home/yourname/tmp
- 确保该文件可执行：
chmod +x ~/.vscode-server/server-env-setup.sh - 完全关闭本地 VS Code（包括托盘进程），再重新连接 Remote-SSH
ENOSPC: no space left on device 的真实来源
别只看 df -h /tmp。很多 HPC 或容器化服务器（Docker/K8s）的 /tmp 是 overlayfs 挂载点，df 显示 100% 并不意味着磁盘物理满，而是该 overlay 层的 upperdir 写满了 —— 其他用户或系统进程可能已占满配额，你无法清理。
典型现象：
-
ls -la /tmp看不到大文件，但df -Th /tmp显示Use%为 100% -
mkdir /tmp/test报ENOSPC，而mkdir ~/tmp/test成功 - Pylance 日志中明确出现
Error: ENOSPC: no space left on device, mkdir '/tmp/pyright-...
这不是权限问题，也不是磁盘坏了，是 overlay 文件系统写入配额耗尽。唯一可靠解法就是换 TMPDIR，别试图 rm -rf /tmp/*。
内存不足引发的崩溃（FATAL ERROR: Allocation failed - JavaScript heap out of memory）
这类崩溃日志里会有 JavaScript heap out of memory 或 MarkCompactCollector 关键字，说明 Node.js 运行时堆内存溢出。Pylance 是基于 Node.js 的，它默认堆上限约 2GB，在大型 Python 项目（尤其含大量第三方包或类型存根）中很容易突破。
必须同时做两件事：
- 在远程服务器的
~/.vscode-server/server-env-setup.sh中追加：export NODE_OPTIONS="--max_old_space_size=6144"
（单位 MB，6144 = 6GB；根据服务器内存调整，别超物理内存 50%） - 在本地工作区的
.vscode/settings.json中加："pylance.memoryLimitMb": 4096
（这是 Pylance 自身的内存软限制，和 Node.js 堆无关，但建议设高些）
注意：NODE_OPTIONS 必须在 server-env-setup.sh 里设，放 settings.json 或 launch.json 里无效 —— 它影响的是 Pylance 后台 worker 进程的启动参数，不是调试进程。
其他容易被忽略的硬性条件
上面三步解决 90% 的崩溃，但还有几个“看似无关却致命”的点：
- 确保
server-env-setup.sh文件权限是644或755，不能是600（VS Code Server 启动时以特定 uid 执行，私有权限会被跳过） - 不要在
server-env-setup.sh里调用python、conda或任何可能阻塞或失败的命令 —— 它必须是纯环境变量导出，否则整个 server 启动失败 - 如果用了 conda/mamba 环境，确认
python解释器路径没指向一个被删掉的虚拟环境，Pylance 启动时会尝试解析site-packages，路径失效也会静默崩溃 -
python.analysis.exclude要填绝对路径（如"/home/yourname/project/build"），相对路径或 glob 不生效，且排除项必须存在，否则可能报错中断
最麻烦的其实是第一点：server-env-setup.sh 放对位置、设对权限、内容干净。很多人卡在这一步，反复重装 Pylance 也没用。
