PAYATHON 2026

为何设置 justMyCode: false 仍无法命中断点?

数据小陈

结论

justMyCode: false 没有生效,配置本身没问题。socket.py 与 Python 标准库的 socket 模块重名,导致模块解析、代码对象或断点绑定出现冲突。justMyCode 只控制调试器是否把某些栈帧当作库代码过滤,以及是否步入库代码;它不能修复模块名遮蔽,也不能保证断点绑定到实际执行的代码对象。最直接可靠的解决方式是重命名文件,清理 __pycache__ 后重启调试。

为什么会这样

  • Python 导入模块时按 sys.path 查找,脚本所在目录通常靠前,socket.py 很容易和标准库 socket 发生命名冲突。asyncio、调试器自身等都可能导入 socket,实际加载的模块身份可能和你编辑器里打开的文件不一致。
  • 断点能否命中,不只取决于 justMyCode。debugpy 需要把 VS Code 里的文件/行号与正在运行的 code object 匹配起来。如果同一个文件以 __main__ 运行,同时又以 socket 模块被导入,可能出现两个模块对象;断点只绑定到其中一个,另一个执行路径就不会停。
  • 模块名是 socket 时,调试器或编辑器可能把它当作标准库模块处理。justMyCode: false 只放宽“用户代码/库代码”的过滤,不会改变模块名解析,也不会把错误映射的源码路径纠正过来。
  • 所以,关键要看断点有没有绑定到实际执行的 handle_client。仅把 justMyCode 设为 false,并不会让所有断点自动生效。

解决步骤

  1. 不要把业务文件命名为标准库同名模块,例如 socket.py、asyncio.py、json.py。改成 my_socket_server.py、socket_server_demo.py 这类名称。
  2. 删除项目里的 __pycache__ 和旧的 .pyc,避免解释器继续使用缓存模块。
  3. 在 launch.json 中把 program 指向重命名后的文件;justMyCode 可以保持默认 true。只有确实要调试标准库/第三方库内部时,才需要改为 false。
  4. 重启调试会话,不要只点重新运行;必要时关闭终端里残留的 Python 进程后再启动。

示例(重命名后):

# my_socket_server.py
import asyncio

async def run_server():
    server = await asyncio.start_server(handle_client, 'localhost', 8888)
    addr = server.sockets[0].getsockname()
    print(f'Serving on {addr}')
    async with server:
        await server.serve_forever()

async def handle_client(reader: asyncio.StreamReader, writer: asyncio.StreamWriter):
    data = await reader.read(100)  # 在这里设置断点
    message = data.decode()
    addr = writer.get_extra_info('peername')
    print(f"Received {message} from {addr}")
    writer.write(f"Hello {message}".encode())
    await writer.drain()
    writer.close()
    await writer.wait_closed()

asyncio.run(run_server())

客户端可以正常命名为 client.py:

import asyncio

async def send_message(message):
    reader, writer = await asyncio.open_connection('localhost', 8888)

    writer.write(message.encode())
    await writer.drain()

    data = await reader.read(100)
    response = data.decode()

    print(f"Received {response}")

    writer.close()
    await writer.wait_closed()

asyncio.run(send_message("World"))

注意事项

  • justMyCode 不会强制所有断点生效。它主要影响调试器是否跳过库代码、是否进入库代码单步;断点本身还需要正确的模块路径和源码映射。
  • 如果 VS Code 里断点是灰色空心圆,通常表示调试器没有成功绑定该行,不要只盯着配置里的 justMyCode。
  • 如果确实需要调试标准库或第三方库,再设置 "justMyCode": false;同时要确认你打开的文件就是实际被加载的文件。
  • 异步函数中的断点本身是支持的,handle_client 不被命中更可能是模块名冲突,async 语法本身并不妨碍断点。
  • 清理缓存并重启调试器后再复现一次;如果仍不命中,检查 launch.json 的 program 是否指向重命名后的文件,以及终端是否残留旧进程占用端口。

备注:内容仅供参考。