Windows 下配置 KDB+、JupyterQ 与 Python (embedPy) 环境

# 创建名为 kdbq 的环境，指定 Python 3.7
conda create -n kdbq python=3.7
# 激活环境
conda activate kdbq

第二步：安装组件

我们需要安装 embedPy (让 Q 能调 Python) 和 jupyterq (Jupyter 的 Q 内核)。

# 使用 pip 安装 embedPy (通常比 conda 源更稳定)
pip install embedPy
# 安装 jupyterq
conda install -c kx jupyterq

第三步：安装 License

将你在邮件中收到的 kc.lic 文件复制到 Anaconda 环境的 q 目录中。

• 默认路径通常在：
  C:\ProgramData\anaconda3\envs\kdbq\q
  或者
  C:\Users\你的用户名\anaconda3\envs\kdbq\q

检查方法：在该目录下应该能看到 w64 文件夹和刚放入的 kc.lic 文件。

4. 关键修正：解决 Windows 特有的 Bug

Windows 环境下直接运行通常会失败，我们需要手动修正两个问题。

修正一：解决 'embedPy requires python 3.6' 误报

问题：embedPy 的启动脚本 p.q 会尝试调用 cmd 检查 Python 版本，但这在 Windows Conda 环境下经常失效，导致误报。

操作：

1. 使用记事本打开文件：...\envs\kdbq\q\p.q
2. 找到第 10 行左右的代码：

if[(o="w")and `3.6>$first@[system"python3 ",;c;{system"python ",c}];'"embedPy requires python ..."];

3. 注释掉它（在行首加 /）：

/if[(o="w")and ... <-- 加上斜杠

4. 保存并关闭。

修正二：解决 'Fault address' 崩溃 (至关重要)

问题：如果不显式设置环境变量，Q 进程找不到 Python 的 DLL，启动时会直接崩溃。

操作：
我们需要在启动 Jupyter 前手动'告诉'系统 Python 在哪里。请在 Anaconda Prompt 中依次执行以下命令（每次启动前都要执行，或者保存为 .bat 脚本）：

:: 1. 确保在环境中
conda activate kdbq
:: 2. 设置 QHOME (告诉 q 它的家在哪)
:: 注意：请根据你的实际 Anaconda 安装路径修改下面的路径
set QHOME=C:\ProgramData\anaconda3\envs\kdbq\q
:: 3. 设置 PYTHONHOME (救命稻草：防止 embedPy 找不到 Python 核心导致崩溃)
set PYTHONHOME=C:\ProgramData\anaconda3\envs\kdbq
:: 4. 强制将 Python 和 Q 加入 PATH 最前端
set PATH=%PYTHONHOME%;%PYTHONHOME%\Library\bin;%PYTHONHOME%\Scripts;%QHOME%\w64;%PATH%
:: 5. 启动 Jupyter
jupyter notebook

5. 验证安装

1. 在 Jupyter Notebook 页面右上角，点击 New -> Q (kdb+)。
2. 输入以下测试代码并运行 (Shift+Enter)：

/ 加载 embedPy
\l p.q
/ 1. 测试基础 Python 打印
.p.eval"print('Hello from Python inside Q!')"
/ 2. 测试数据交换 (numpy)
np:.p.import`numpy
arr:np[`arange](10)
show arr

如果输出了 Hello... 和一个 0-9 的数组，恭喜你！你已经成功打通了 KDB+ 与 Python 的集成。

常见问题速查表